Ausführen des Clientanalysetools unter macOS

Wenn bei Microsoft Defender for Endpoint unter macOS Zuverlässigkeits- oder Geräteintegritätsprobleme auftreten, können Sie die XMDE-Clientanalyse verwenden, um diese Probleme zu diagnostizieren. In diesem Artikel werden zwei Möglichkeiten zur Verwendung des Clientanalysetools beschrieben:

1. Verwenden einer Binärversion (keine externe Python-Abhängigkeit)
2. Verwenden einer Python-basierten Lösung

Verwenden der binärversion des Clientanalysetools

1. Laden Sie das XMDE Client Analyzer Binary-Tool auf den macOS-Computer herunter, den Sie untersuchen müssen.

   Wenn Sie ein Terminal verwenden, laden Sie das Tool herunter, indem Sie den folgenden Befehl ausführen:

   curl -s -L -o XMDEClientAnalyzerBinary.zip "https://aka.ms/XMDEClientAnalyzerBinary"
   

2. Überprüfen Sie den Download.

   echo '8707A2327A0B3D7AE6734D9CA34E116FC628DA23FDCA61C7BA7C7A9965F0BE34  XMDEClientAnalyzerBinary.zip' | shasum -a 256 -c
   

3. Extrahieren Sie den Inhalt von XMDEClientAnalyzerBinary.zip auf dem Computer.

   Wenn Sie ein Terminal verwenden, extrahieren Sie die Dateien, indem Sie den folgenden Befehl ausführen:

   unzip -q XMDEClientAnalyzerBinary.zip -d XMDEClientAnalyzerBinary
   

4. Wechseln Sie zum Verzeichnis des Tools, indem Sie den folgenden Befehl ausführen:

   cd XMDEClientAnalyzerBinary/XMDEClientAnalyzer
   

5. Beachten Sie, dass die folgenden beiden ZIP-Dateien erstellt werden:

   • SupportToolLinuxBinary.zip: Für alle Linux Geräte
   • SupportToolMacOSBinary.zip: Für Mac-Geräte

6. Entzippen Sie die SupportToolMacOSBinary.zip.

    unzip -q SupportToolMacOSBinary.zip
   

7. Führen Sie das Tool als Root aus, um Ihr Diagnosepaket zu erstellen:

   sudo ./MDESupportTool -d --mdatp-log debug
   

Verwenden des Python-basierten Clientanalysetools

Das Client-Analysetool ist auf einige zusätzliche PIP-Pakete (decorator, sh, distro, lxml und psutil) angewiesen, die im Root-Modus im Betriebssystem installiert werden, um die Ergebnisausgabe zu erzeugen. Wenn es nicht installiert ist, versucht das Analysetool, es aus dem offiziellen Repository für Python-Pakete abzurufen.

Für das Tool muss derzeit Python Version 3 oder höher auf Ihrem Gerät installiert sein. Wenn sich Ihr Gerät hinter einem Proxy befindet, können Sie den Proxyserver als Umgebungsvariable an das mde_support_tool.sh Skript übergeben. Beispiel: https_proxy=https://myproxy.contoso.com:8080 ./mde_support_tool.sh".

1. Laden Sie das XMDE-Client analyzer-Tool auf den Mac-Computer herunter, den Sie untersuchen.

   Wenn Sie ein Terminal verwenden, laden Sie das Tool herunter, indem Sie den folgenden Befehl ausführen:

   curl -L -o XMDEClientAnalyzer.zip https://aka.ms/XMDEClientAnalyzer
   

2. Überprüfen Sie den Download, indem Sie einen der folgenden Befehle ausführen:

   • Linux:

     echo 'CCADC17FDE907E63FBAF0A5F9D0FAA2FC6D03C49CBA62276BDE427D0F512167F  XMDEClientAnalyzer.zip' | sha256sum -c
     

   • macOS:

     echo 'CCADC17FDE907E63FBAF0A5F9D0FAA2FC6D03C49CBA62276BDE427D0F512167F  XMDEClientAnalyzer.zip' | shasum -a 256 -c
     

3. Extrahieren Sie den Inhalt von XMDEClientAnalyzer.zip auf dem Computer.

   Wenn Sie ein Terminal verwenden, extrahieren Sie die Dateien mit dem folgenden Befehl:

   unzip -q XMDEClientAnalyzer.zip -d XMDEClientAnalyzer
   

4. Wechseln Sie in das Verzeichnis des extrahierten Speicherorts.

   cd XMDEClientAnalyzer
   

5. Geben Sie dem Tool Ausführungsberechtigung:

   chmod a+x mde_support_tool.sh
   

6. Führen Sie als Nicht-Root-Benutzer aus, um erforderliche Abhängigkeiten zu installieren:

   ./mde_support_tool.sh
   

7. Wenn Sie Dateien unter macOS herunterladen, wird automatisch ein neues erweitertes Attribut namens com.apple.quarantine hinzugefügt, das von Gatekeeper gescannt wird. Vor der Ausführung sollten Sie dieses erweiterte Attribut entfernen:

   xattr -c MDESupportTools
   

   Andernfalls wird möglicherweise die folgende Warnung angezeigt:

   Möglicherweise wird die Meldung „„MDESupportTool“ nicht geöffnet“ angezeigt.

   Apple konnte nicht überprüfen, ob "MDESupportTool" frei von Schadsoftware ist, die Ihren Mac beschädigen oder Ihre Privatsphäre gefährden könnte"

8. Führen Sie den Befehl erneut als Root aus, um das eigentliche Diagnosepaket zu sammeln und das Ergebnisarchiv zu erzeugen:

   sudo ./mde_support_tool.sh -d --mdatp-log debug
   

Befehlszeilenoptionen

Primäre Befehlszeilen

Verwenden Sie den folgenden Befehl, um die Computerdiagnose abzurufen.

-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)

Verwendungsbeispiel: sudo ./MDESupportTool -d --mdatp-log debug

Positionsargumente

Sammeln von Leistungsinformationen

Erfassen Sie umfangreiche Nachverfolgungsdaten zur Maschinenleistung für die Analyse eines Leistungsszenarios, das sich bei Bedarf reproduzieren lässt.

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

Verwendungsbeispiel: sudo ./MDESupportTool performance --frequency 2

Verwenden Sie OS-Trace (nur für macOS)

Verwenden Sie die Tracingfunktionen des Betriebssystems, um Leistungsprotokolle für Defender for Endpoint aufzuzeichnen.

-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

Wenn dieser Befehl zum ersten Mal ausgeführt wird, wird eine Profilkonfiguration installiert.

Informationen zum Genehmigen der Profilinstallation finden Sie im Apple-Supporthandbuch.

Verwendungsbeispiel ./mde_support_tool.sh trace --length 5

Inhalt des Ergebnispakets unter macOS

Siehe auch

Problembehandlung für Defender for Endpoint unter macOS

Problembehandlungsmodus in Microsoft Defender for Endpoint unter macOS

Behandeln von Installationsproblemen für Microsoft Defender for Endpoint unter macOS

Behandeln von Lizenzproblemen für Microsoft Defender for Endpoint unter macOS

Behandeln von Problemen mit Systemerweiterungen in Microsoft Defender for Endpoint unter macOS

Behandeln von Problemen mit der Cloudkonnektivität für Microsoft Defender for Endpoint unter macOS

Übersicht zur Behandlung von Leistungsproblemen für Microsoft Defender for Endpoint unter macOS

Behebung von Fehlalarmen/falschen positiven Ergebnissen in Microsoft Defender for Endpoint