تشغيل محلل العميل على macOS

مقالة
01/09/2025

إذا كنت تواجه مشكلات في الموثوقية أو سلامة الجهاز مع Microsoft Defender لنقطة النهاية على macOS، يمكنك استخدام محلل عميل XMDE لتشخيص هذه المشكلات. توضح هذه المقالة طريقتين لاستخدام أداة محلل العميل:

استخدام إصدار ثنائي (لا توجد تبعية Python خارجية)
استخدام حل يستند إلى Python

استخدام الإصدار الثنائي من محلل العميل

قم بتنزيل أداة XMDE Client Analyzer Binary إلى جهاز macOS الذي تحتاج إلى التحقيق فيه.

إذا كنت تستخدم محطة طرفية، فقم بتنزيل الأداة عن طريق تشغيل الأمر التالي:
```
wget --quiet -O XMDEClientAnalyzerBinary.zip https://go.microsoft.com/fwlink/?linkid=2297517
```

تحقق من التنزيل.

echo '4E96E75B16244BB25BDBF34CBB3EB596BC2E9CE368BC4E532E8AE12DF2A1E19D  XMDEClientAnalyzerBinary.zip' | shasum -a 256 -c

استخراج محتويات XMDEClientAnalyzerBinary.zip على الجهاز.

إذا كنت تستخدم محطة طرفية، فاستخرج الملفات عن طريق تشغيل الأمر التالي:
```
unzip -q XMDEClientAnalyzerBinary.zip -d XMDEClientAnalyzerBinary
```
قم بالتغيير إلى دليل الأداة عن طريق تشغيل الأمر التالي:
```
cd XMDEClientAnalyzerBinary
```
لاحظ أنه يتم إنتاج الملفين المضغوطين التاليين:
- SupportToolLinuxBinary.zip: لجميع أجهزة Linux
- SupportToolMacOSBinary.zip: لأجهزة Mac
فك ضغط SupportToolMacOSBinary.zip.
```
 unzip -q SupportToolMacOSBinary.zip
```
قم بتشغيل الأداة كجذر لإنشاء حزمة التشخيص الخاصة بك:
```
sudo ./MDESupportTool -d
```

استخدام محلل العميل المستند إلى Python

يعتمد محلل العميل على عدد قليل من حزم PIP الإضافية (decoratorو shdistroوlxmlpsutil) المثبتة في نظام التشغيل عند وضع الجذر لإنتاج إخراج النتيجة. إذا لم يتم تثبيته، يحاول المحلل إحضاره من المستودع الرسمي لحزم Python.

تتطلب الأداة حاليا تثبيت إصدار Python 3 أو أحدث على جهازك. إذا كان جهازك خلف وكيل، فيمكنك تمرير الخادم الوكيل كمتغير بيئة إلى mde_support_tool.sh البرنامج النصي. على سبيل المثال: https_proxy=https://myproxy.contoso.com:8080 ./mde_support_tool.sh".

تحذير

يتطلب تشغيل محلل العميل المستند إلى Python تثبيت حزم PIP التي قد تتسبب في بعض المشكلات في بيئتك. لتجنب حدوث مشكلات، يوصى بتثبيت الحزم في بيئة PIP للمستخدم.

قم بتنزيل أداة محلل عميل XMDE إلى جهاز Mac الذي تحقق فيه.

إذا كنت تستخدم محطة طرفية، فقم بتنزيل الأداة عن طريق تشغيل الأمر التالي:
```
wget --quiet -O XMDEClientAnalyzer.zip https://aka.ms/XMDEClientAnalyzer
```

تحقق من التنزيل.

نظام التشغيل	أمر
Linux	`echo '84C9718FF3D29DA0EEE650FB2FC0625549A05CD1228AC253DBB92C8B1D9F1D11 XMDEClientAnalyzer.zip'\| sha256sum -c`
macOS	`echo '84C9718FF3D29DA0EEE650FB2FC0625549A05CD1228AC253DBB92C8B1D9F1D11 XMDEClientAnalyzer.zip'\| shasum -a 256 -c`

استخراج محتويات XMDEClientAnalyzer.zip على الجهاز.

إذا كنت تستخدم محطة طرفية، فاستخرج الملفات باستخدام الأمر التالي:
```
unzip -q XMDEClientAnalyzer.zip -d XMDEClientAnalyzer
```
تغيير الدليل إلى الموقع المستخرج.
```
cd XMDEClientAnalyzer
```
منح الأداة إذنا قابلا للتنفيذ:
```
chmod a+x mde_support_tool.sh
```
قم بتشغيل كمستخدم غير مستخدم لتثبيت التبعيات المطلوبة:
```
./mde_support_tool.sh
```
عند تنزيل الملفات على macOS، فإنه يضيف تلقائيا سمة موسعة جديدة تسمى com.apple.quarantine التي يتم مسحها ضوئيا بواسطة Gatekeeper. قبل التشغيل، ستحتاج إلى إزالة هذه السمة الموسعة:
```
xattr -c MDESupportTools
```
وإلا فقد تتلقى التحذير التالي:

"قد تحصل على "MDESupportTool" غير مفتوح

تعذر على Apple التحقق من أن "MDESupportTool" خال من البرامج الضارة التي قد تضر بجهاز Mac أو تعرض خصوصيتك للخطر"
لجمع حزمة التشخيص الفعلية وإنشاء ملف أرشيف النتائج، قم بتشغيل مرة أخرى كجذر:
```
sudo ./mde_support_tool.sh -d
```

خيارات سطر الأوامر

أسطر الأوامر الأساسية

استخدم الأمر التالي للحصول على تشخيص الجهاز.

-h, --help            show this help message and exit
--output OUTPUT, -o OUTPUT
                      Output path to export report
--outdir OUTDIR       Directory where diagnostics file will be generated
--no-zip, -nz         If set a directory will be created instead of an archive file
--force, -f           Will overwrite if output directory exists
--diagnostic, -d      Collect extensive machine diagnostic information
--bypass-disclaimer   Do not display disclaimer banner
--interactive, -i     Interactive diagnostic
--delay DELAY, -dd DELAY
                      Set MDATP log level. If you use interactive or delay mode, the log level will set to debug automatically, and reset after 48h.
--mdatp-log {info,debug,verbose,error,trace,warning}
                      Set MDATP log level
--max-log-size MAX_LOG_SIZE
                      Maximum log file size in MB before rotating(Will restart mdatp)

مثال الاستخدام: sudo ./MDESupportTool -d

ملاحظة

تتوفر ميزة الضبط التلقائي على مستوى السجل فقط في إصدار العميل 2405 أو أحدث.

الوسيطات الموضعية

جمع معلومات الأداء

اجمع تتبع أداء الجهاز الشامل لتحليل سيناريو الأداء الذي يمكن إعادة إنتاجه عند الطلب.

-h, --help            show this help message and exit
--frequency FREQUENCY
                      profile at this frequency
--length LENGTH       length of time to collect (in seconds)

مثال الاستخدام: sudo ./MDESupportTool performance --frequency 2

استخدام تتبع نظام التشغيل (لنظام التشغيل macOS فقط)

استخدم مرافق تتبع نظام التشغيل لتسجيل تتبعات أداء Defender لنقطة النهاية.

ملاحظة

هذه الوظيفة موجودة في حل Python فقط.

-h, --help       show this help message and exit
--length LENGTH  Length of time to record the trace (in seconds).
--mask MASK      Mask to select with event to trace. Defaults to all

عند تشغيل هذا الأمر لأول مرة، يقوم بتثبيت تكوين ملف التعريف.

للموافقة على تثبيت ملف التعريف، راجع دليل دعم Apple.

مثال الاستخدام ./mde_support_tool.sh trace --length 5

محتويات حزمة النتائج على macOS

ملف	الوصف
`report.html`	ملف إخراج HTML الرئيسي الذي يحتوي على النتائج والإرشادات من تشغيل أداة محلل العميل على الجهاز. يتم إنشاء هذا الملف فقط عند تشغيل الإصدار المستند إلى Python من أداة محلل العميل.
`mde_diagnostic.zip`	نفس الإخراج التشخيصي الذي يتم إنشاؤه عند التشغيل `mdatp diagnostic create` على macOS.
`mde.xml`	إخراج XML الذي يتم إنشاؤه أثناء التشغيل ويستخدم لإنشاء ملف تقرير html.
`Processes_information.txt`	يحتوي على تفاصيل التشغيل Microsoft Defender لنقطة النهاية العمليات ذات الصلة على النظام.
`Log.txt`	يحتوي على نفس رسائل السجل المكتوبة على الشاشة أثناء جمع البيانات.
`Health.txt`	نفس إخراج الصحة الأساسي الذي يظهر عند تشغيل أمر صحة mdatp .
`Events.xml`	ملف XML آخر يستخدمه المحلل عند إنشاء تقرير HTML.
`Audited_info.txt`	تفاصيل حول الخدمة المدققة والمكونات ذات الصلة لنظام التشغيل Linux .
`perf_benchmark.tar.gz`	تقارير اختبار الأداء. لا ترى هذا الملف إلا إذا كنت تستخدم معلمة الأداء.