رفيق الدعم

#رفيق الدعم

وصف

Support Companion هو تطبيق مساعد لنظام التشغيل macOS، مصمم لتمكين المستخدمين النهائيين من خلال تزويدهم بوصول سريع وسهل إلى المعلومات والإجراءات المهمة. تم تصميم هذا التطبيق لتبسيط مجموعة متنوعة من المهام، مما يلغي الحاجة إلى البحث المكثف والتنقل المعقد. تم تجهيز Support Companion بمجموعة من الميزات التي تعمل على تحسين إنتاجية المستخدم.

فهو يتكامل مع Munki وIntune للحصول على معلومات التطبيق وتحديثاته، مما يوفر منصة موحدة لإدارة هذه الخدمات. يمكن للمستخدمين عرض معلومات النظام مثل إصدار macOS والطراز والرقم التسلسلي في لمحة واحدة، وتنفيذ إجراءات مثل تغيير كلمات المرور وإعادة التشغيل والمزيد ببضع نقرات فقط.

يعتمد هذا الإصدار الأولي على Munki و/أو Intune للحصول على معلومات التطبيق وتحديثاته. إذا كنت لا تستخدم Munki أو Intune، فقد لا يوفر هذا التطبيق معلومات تفصيلية في الوقت الحالي.

إذا كانت هناك رغبة في إضافة إجراءات ومعلومات أخرى خاصة بـ MDM، فيرجى إبلاغي بذلك. أنا منفتح على إضافة المزيد من موفري MDM في المستقبل إذا كان هناك طلب عليهم. لا يمكنني إجراء الاختبار إلا باستخدام Intune، لذا إذا كان لديك موفر MDM آخر، سأكون ممتنًا لمساعدتك في الاختبار.

سمات

• الإجراءات : قم بتنفيذ إجراءات مثل تغيير كلمة المرور، وKill Intune MDM Agent، وجمع السجلات، وإعادة التشغيل، والمزيد.

• معلومات النظام : عرض معلومات النظام بسرعة مثل إصدار macOS والطراز والرقم التسلسلي ووقت التشغيل الأخير.

• Evergreen : تعرف على أجهزة Munki التي تقوم بفهرسة الأجهزة التي تكون عضوًا فيها (يتطلب بيان جهاز محلي مع SN كاسم).

• البطارية : عرض معلومات البطارية مثل عدد الدورات والصحة.

• MDM : عرض معلومات MDM مثل حالة التسجيل وتاريخ التسجيل.

• القرص : عرض معلومات القرص مثل مساحة القرص وحالة FileVault.

• تقدم تصحيح التطبيق : عرض التقدم المحرز في تصحيح التطبيقات.

• التحديثات المعلقة : عرض التحديثات المعلقة للتطبيقات.

• التطبيقات : عرض التطبيقات المثبتة وإصداراتها.

• الهوية : عرض معلومات الملف الشخصي للمستخدم الحالي ومعلومات Kerberos SSO أو Platform SSO.

• معلومات سطح المكتب : عرض المعلومات على سطح المكتب مثل اسم الجهاز والرقم التسلسلي وإصدار macOS وعنوان IP.

• عناصر واجهة المستخدم المخصصة : قم بإضافة عناصر واجهة مستخدم مخصصة إلى طريقة العرض الرئيسية، مما يسمح بعرض معلومات خاصة بمؤسستك.

• الخدمة الذاتية : يعرض جميع الإجراءات في التطبيق الذي تم تكوينه في ملف تعريف MDM. يتيح ذلك تجربة الخدمة الذاتية للمستخدم باستخدام واجهة المستخدم وليس فقط رمز شريط القائمة.

التعريب

يتم ترجمة التطبيق إلى Swedish Norwegian French German . سيتم عرض التطبيق باللغة المفضلة للمستخدم إذا تم ضبطه على إحدى هذه اللغات في نظام التشغيل macOS. إذا لم تكن اللغة المفضلة للمستخدم واحدة من هذه اللغات، فسيتم تعيين التطبيق افتراضيًا على اللغة الإنجليزية.

المساهمات في اللغات الأخرى هي موضع ترحيب!

تثبيت

1. احصل على أحدث مثبت PKG من الإصدارات.

2. قم بتنزيل وتثبيت حزمة MacAdmins Python من هنا.

• يعد هذا مطلوبًا حتى يتمكن التطبيق من تشغيل البرامج النصية مثل جمع معلومات MDM.

3. قم بتشغيل برنامج تثبيت PKG.

4. خياري

• قم بتثبيت حزمة Launch Agent المرفقة بالإصدار لبدء تشغيل التطبيق تلقائيًا ومواصلة تشغيله.

الملفات المثبتة

يتم تثبيت التطبيق في المجلد /Applications/Utilities ويتم تثبيت الملفات والمجلدات التالية:

• /Applications/Utilities/SupportCompanion.app - حزمة التطبيق

• /Library/Application Support/SupportCompanion - المجلد الذي يحتوي على الملفات التالية:

• Scripts - البرامج النصية المستخدمة للحصول على معلومات مثل حالة MDM

• ملفات JSON التي تم إنشاؤها بواسطة البرامج النصية ليقرأها التطبيق

• /Library/LaunchDaemons/com.almenscorner.supportcompanion.plist - LaunchDaemon للتطبيق لتشغيل البرامج النصية

• ~/Library/Application Support/SupportCompanion/ - مجلد يحتوي على بيانات التطبيق مثل الطوابع الزمنية للإشعارات

إلغاء التثبيت

يتم تضمين البرنامج النصي لإلغاء التثبيت في حزمة التطبيق. يمكن العثور على البرنامج النصي في الموقع التالي: /Applications/Utilities/Support Companion.app/Contents/Resources/Uninstall.sh

حول وكيل الإطلاق

سيقوم وكيل الإطلاق المقدم كحزمة موقعة وموثقة ومثبتة، في حالة تثبيته وتحميله بما يلي:

• ابدأ تشغيل التطبيق إذا لم يكن قيد التشغيل

• قم ببدء تشغيل التطبيق مرة أخرى في حالة إنهاء المستخدم

• ابدأ التطبيق عند تسجيل الدخول

يعد وكيل الإطلاق هذا اختياريًا، ويمكنك إنشاء وكيل الإطلاق الخاص بك إذا كنت تفضل ذلك.

حول باقة الجناح

حزمة المجموعة عبارة عن حزمة موقعة وموثقة ومثبتة تحتوي على التطبيق وحزمة Launch Agent. يتم توفير هذه الحزمة للراحة ويمكن استخدامها لتثبيت التطبيق وعامل الإطلاق في نفس الوقت.

AutoPkg

تتوفر وصفة لـ AutoPkg هنا.

ملاحظة على الرموز

عند تكوين أيقونات لعناصر واجهة المستخدم أو الإجراءات المخصصة، يجب أن يكون اسم الرمز اسم رمز مادة من https://pictogrammers.com/library/mdi/. على سبيل المثال، سيكون مكتشف التفاح هو AppleFinder.

باستخدام التطبيق

عند بدء تشغيل التطبيق، سيظهر رمز شريط القوائم. سيؤدي النقر فوق الرمز إلى إظهار الإجراءات المتاحة التي يجب اتخاذها مثل فتح التطبيق. لن يتم عرض أي رمز إرساء للتطبيق ويجب الوصول إلى التطبيق من رمز شريط القائمة. يهدف هذا إلى إبعاد التطبيق عن الطريق وعدم حدوث فوضى في شريط الإرساء وتسهيل قيام المسؤولين ببدء تشغيل التطبيق من محطة طرفية أو برنامج نصي دون عرض التطبيق للمستخدم النهائي. تؤدي تهيئة التطبيق بهذه الطريقة إلى إرسال إشعارات إلى المستخدم إذا كانت لديه تحديثات برامج متوفرة على سبيل المثال.

استكشاف الأخطاء وإصلاحها

يمكن عرض السجلات عن طريق تشغيل الأمر التالي في الوحدة الطرفية: log stream --debug --info --predicate 'subsystem contains "com.almenscorner.supportcompanion"'

أو من خلال البحث عن subsystem: com.almenscorner.supportcompanion في تطبيق Console.

إعدادات

يمكن تكوين العديد من جوانب التطبيق باستخدام ملفات تعريف MDM، وتتوفر المفاتيح التالية:

مفتاح	يكتب	تقصير	مطلوب	وصف
BrandName	خيط	لا أحد	خطأ شنيع	يقوم بتكوين اسم العلامة التجارية الموضح في القائمة
BrandColor	خيط	أزرق	خطأ شنيع	تكوين لون العلامة التجارية الموضح في التطبيق، الألوان المتاحة هي: الأزرق، الأخضر، الأحمر، البرتقالي
BrandLogo	خيط	لا أحد	خطأ شنيع	يقوم بتكوين شعار العلامة التجارية الموضح في القائمة الجانبية للتطبيقات. حدد مسارًا محليًا أو سلسلة Base64
SupportPageUrl	خيط	لا أحد	خطأ شنيع	يقوم بتكوين عنوان URL ليتم فتحه عندما ينقر المستخدم على زر الحصول على الدعم
ChangePasswordUrl	خيط	لا أحد	خطأ شنيع	يقوم بتكوين عنوان URL ليتم فتحه عندما ينقر المستخدم على زر تغيير كلمة المرور
ChangePasswordMode	خيط	محلي	خطأ شنيع	تكوين الوضع لزر تغيير كلمة المرور، الأوضاع المتاحة هي: local ، SSOExtension ، url
SupportEmail	خيط	لا أحد	خطأ شنيع	يقوم بتكوين عنوان البريد الإلكتروني الذي يظهر عندما ينقر المستخدم على زر معلومات الدعم
SupportPhone	خيط	لا أحد	خطأ شنيع	تكوين رقم الهاتف الذي يظهر عندما ينقر المستخدم على زر معلومات الدعم
HiddenWidgets	صفيف	لا أحد	خطأ شنيع	تكوين الأدوات التي تريد إخفاءها، الأدوات المتاحة هي: DeviceInfo و MunkiPendingApps و MunkiUpdates و IntunePendingApps و IntuneUpdates و Storage و MdmStatus و Actions و Battery و EvergreenInfo
HiddenActions	صفيف	لا أحد	خطأ شنيع	تكوين الإجراءات المطلوب إخفاؤها، والإجراءات المتاحة هي: Support و ManagedSoftwareCenter و ChangePassword و Reboot و KillAgent و SoftwareUpdates و GatherLogs
NotificationInterval	عدد صحيح	4	خطأ شنيع	تكوين الفاصل الزمني للإشعارات بالساعات لإشعارات تحديثات التطبيقات وتحديثات البرامج. يؤدي الإعداد إلى 0 إلى تعطيل الإشعارات
NotificationTitle	خيط	رفيق الدعم	خطأ شنيع	تكوين عنوان الإخطارات
NotificationImage	خيط	لا أحد	خطأ شنيع	تكوين صورة لإضافتها إلى الإخطارات. يجب تحديد المسار
SoftwareUpdateNotificationMessage	خيط	لديك تحديثات البرامج المتاحة. اتخاذ الإجراءات اللازمة الآن! ud83cudf89	خطأ شنيع	تكوين الرسالة للإشعارات الخاصة بإشعارات تحديثات البرامج
SoftwareUpdateNotificationButtonText	خيط	التفاصيل ud83dudc40	خطأ شنيع	يقوم بتكوين نص الزر للإشعارات الخاصة بإشعارات تحديثات البرامج
AppUpdateNotificationMessage	خيط	لديك تحديثات التطبيق المتاحة. اتخاذ الإجراءات اللازمة الآن! ud83cudf89	خطأ شنيع	تكوين الرسالة للإشعارات الخاصة بإشعارات تحديثات التطبيق
AppUpdateNotificationButtonText	خيط	التفاصيل ud83dudc40	خطأ شنيع	يقوم بتكوين نص الزر للإشعارات الخاصة بإشعارات تحديثات التطبيق
CustomColors	صفيف	لا أحد	خطأ شنيع	تكوين الألوان المخصصة للتطبيق، يجب تحديدها بتنسيق سداسي عشري، انظر المثال أدناه. لا تستخدم BrandColor مع هذا المفتاح
IntuneMode	بول	خطأ شنيع	خطأ شنيع	تكوين التطبيق لاستخدام Intune للحصول على معلومات التطبيق. يدعم فقط التطبيقات من نوع PKG وDMG، وليس LOB.
LogFolders	صفيف	/ المكتبة / السجلات / Microsoft	خطأ شنيع	تكوين مجلدات السجل لجمع السجلات منها. يستخدم فقط عند جمع السجلات.
Actions	صفيف	لا أحد	خطأ شنيع	يقوم بتكوين الإجراءات المخصصة لإضافتها إلى قائمة الدرج. انظر المثال أدناه.
ShowMenuToggle	بول	حقيقي	خطأ شنيع	يقوم بتكوين ما إذا كان سيتم عرض زر تبديل القائمة في القائمة الجانبية للتطبيقات.
ShowDesktopInfo	بول	خطأ شنيع	خطأ شنيع	تكوين ما إذا كان سيتم عرض المعلومات على سطح المكتب.
DesktopPosition	خيط	أعلى اليمين	خطأ شنيع	تكوين موضع معلومات سطح المكتب، والمواضع المتاحة هي: TopLeft و TopRight و BottomLeft و BottomRight
DesktopInfoLevel	خيط	ممتلىء	خطأ شنيع	تكوين مستوى المعلومات التي سيتم عرضها على سطح المكتب، والمستويات المتاحة هي: Minimal ، Hardware ، Full ، Custom
DesktopInfoCustomItems	صفيف	لا أحد	خطأ شنيع	إذا تم تعيين DesktopInfoLevel على Custom ، فاستخدم هذا المصفوفة لتحديد المعلومات التي سيتم عرضها. المعلومات المتوفرة هي: HostName ، Model ، SerialNumber ، Processor IpAddress ، MemSize ، OsBuild ، OsVersion ، LastBootTime ، StorageInfo ، SupportPhone ، SupportEmail ، Separator
DesktopInfoBackgroundColor	خيط	شفاف	خطأ شنيع	تكوين لون الخلفية لمعلومات سطح المكتب. قم بالتكوين باستخدام تنسيق Hex
DesktopInfoBackgroundOpacity	حقيقي	1.0	خطأ شنيع	يقوم بتكوين عتامة الخلفية لمعلومات سطح المكتب. تكوين قيمة بين 1.0 - 0.1
DesktopInfoColorHighlight	بول	حقيقي	خطأ شنيع	يقوم بتكوين ما إذا كان سيتم تمييز النص في معلومات سطح المكتب.
DesktopInfoFontSize	عدد صحيح	17	خطأ شنيع	تكوين حجم الخط لمعلومات سطح المكتب.
CustomWidgetsPath	خيط	لا أحد	خطأ شنيع	يقوم بتكوين مسار إلى ملف JSON يحتوي على عناصر واجهة مستخدم مخصصة لعرضها في طريقة العرض الرئيسية.
SystemProfilerApps	بول	لا أحد	خطأ شنيع	يقوم بتكوين التطبيق لسرد جميع التطبيقات المثبتة ضمن /Applications وإصداراتها. مفيد في حالة عدم استخدام Munki أو Intune.

تكوين المثال

للتبديل من Munki إلى Intune للحصول على معلومات التطبيق، أضف المفتاح التالي إلى ملف التعريف:

 IntuneMode
<صحيح/>

 

<إصدار القائمة = "1.0">
  <ديكت>
    PayloadContent
    <صفيف>
      <ديكت>
        اسم العلامة التجارية
        AwesomeCorp
        تغيير وضع كلمة المرور
        SSOExtension
        الألوان المخصصة
        <صفيف>
          <ديكت>
            اللون الأساسي
            #00A0D0
            لون التمييز
            #45637A
          
        
        الإجراءات
        <صفيف>
           <ديكت>
               الاسم
               هل تريد إعادة تشغيل الحافظة؟
               الأمر
               killall pboard
           
           <ديكت>
               الاسم
               أعد تشغيل Intune Agent ⚡️
               الأمر
               /usr/bin/osascript -e 'تنفيذ البرنامج النصي لـ Shell "sudo killall IntuneMdmAgent" بامتيازات المسؤول'
           
            <ديكت>
                الاسم
                ️بعض الإجراءات الرائعة
                الأمر
                echo "أنا رائع"رمز
                AppleFinder
            
        
        عنوان الإشعارات
        AwesomeCorp IT
        PayloadDisplayName
        SupportCompanion
        معرف الحمولة
        SupportCompanion
        نوع الحمولة
        SupportCompanion
        PayloadUUID
        a7a0d79f-1cf0-42f2-bc7e-e67d7413a3c5
        PayloadVersion
        <عدد صحيح>1
        البريد الإلكتروني للدعم
        [email protected]
        هاتف الدعم
        123-456-789
        SupportUrl
        https://awesomecorp.support
      
    
    PayloadDisplayName
    SupportCompanion
    معرف الحمولة
    9c4a8e5e-4c70-4b82-83f7-44a053c146f4
    نوع الحمولة
    التكوين
    PayloadUUID
    3D47F3E6-62ED-4668-A30F-6DA1DAE87B18
    PayloadVersion
    <عدد صحيح>1
  

ملخص

بيت

تطبيقات

هوية

معلومات الدعم

جمع السجلات

معلومات سطح المكتب

إشعارات

الاعتمادات

• AvaloniaUI

• SukiUI