Desktop Analytics Protokollsammler

  • Artikel

Verwenden Sie das DesktopAnalyticsLogsCollector.ps1-Tool aus dem Configuration Manager Installationsverzeichnis, um Probleme bei der Desktop Analytics Geräteregistrierung zu beheben. Es führt einige grundlegende Schritte zur Problembehandlung aus und sammelt die relevanten Protokolle in einem einzigen Arbeitsverzeichnis. Sie können diesen Inhalt für Microsoft Support freigeben.

Voraussetzungen

Verwendung

Rufen Sie das Skript aus dem Configuration Manager Installationsinhalt ab:SMSSETUP\TOOLS\DesktopAnalyticsLogsCollector\DesktopAnalyticsLogsCollector.ps1

DesktopAnalyticsLogsCollector.ps1
    [-LogPath] <String>
    [-LogMode] <Int16>
    [-CollectNetTrace] <Int16>
    [-CollectUTCTrace] <Int16>

Parameter

-LogPath

Gibt einen lokalen oder UNC-Pfad an, um das Protokoll und andere Ausgabedateien zu speichern.

Werte:

  • Lokaler Pfad (maximale Länge = 130), z. B.: c:\myfolder

  • UNC-Pfad (maximale Länge = 130), z. B.: \\myserver\myfolder

Typ: Zeichenfolge

Position: 1

Standardwert: $Env:SystemDrive\M365AnalyticsLogs (Wenn dieser Parameter NULL, leer oder leer ist, erstellt das Skript den Ordner M365AnalyticsLogs unter dem Systemlaufwerk.)

-LogMode

Gibt die ausführliche Ebene der Protokolle an.

Werte:

  • 0: Protokollieren von Skriptmeldungen nur im PowerShell-Befehlsfenster.

  • 1: Protokollieren Sie Skriptmeldungen in beiden Protokolldateien im Ausgabeordner und im PowerShell-Befehlsfenster.

  • 2: Protokollieren Sie Skriptmeldungen nur in der Protokolldatei unter dem Ausgabeordner.

Typ: Int16

Position: 2

Standardwert: 1 (Protokollskriptmeldungen sowohl in der Protokolldatei als auch im PowerShell-Befehlsfenster protokollieren.)

-CollectNetTrace

Gibt an, ob das Skript die Netzwerkablaufverfolgung sammelt.

Werte:

  • 0: Aktivieren Sie die Netzwerkablaufverfolgung nicht.

  • 1 (beliebiger ganzzahliger Wert ungleich Null): Aktivieren Sie die Netzwerkablaufverfolgung, und sammeln Sie Ergebnisse.

Typ: Int16

Position: 3

Standardwert: 0 (Aktivieren Sie die Netzwerkablaufverfolgung nicht)

-CollectUTCTrace

Gibt an, ob das Skript die Windows UTC-Ablaufverfolgung erfasst und die Konnektivitätsdiagnose ausgeführt wird.

Werte:

  • 0: Aktivieren Sie die UTC-Ablaufverfolgung nicht, oder führen Sie keine Konnektivitätsdiagnose aus.

  • 1 (beliebiger ganzzahliger Wert ungleich Null): Aktivieren Sie die UTC-Ablaufverfolgung, führen Sie die Konnektivitätsdiagnose aus, und sammeln Sie Ergebnisse.

Typ: Int16

Position: 4

Standardwert: 0 (Aktivieren Sie weder die UTC-Ablaufverfolgung noch führen Sie die Konnektivitätsdiagnose aus.)

Ausgabe

Das Skript erstellt einen Arbeitsordner unter dem angegebenen Pfad. Beispiel: M365AnalyticsLogs_yy_MM_dd_HH_mm_ss. Alle Ausgabedateien werden in diesem Arbeitsordner abgelegt.

Wenn Sie das Skript aktivieren, um in eine Protokolldatei zu schreiben, wird eine im Arbeitsordner generiert. Beispiel: M365AnalyticsLogs_ yy_MM_dd_HH_mm_ss.txt.

Das Skript generiert auch andere Diagnosedateien im Arbeitsordner. Zum Beispiel:

  • installedKBs.txt: eine Liste der auf dem Gerät installierten Windows-Updates
  • appcompat: Anwendungskompatibilitätsdaten
  • Reg*.txt: eine Reihe von Dateien mit exportierten Daten aus der Windows-Registrierung

Beispiele

Beispiel 1: Ausführen eines Skripts über das PowerShell-Befehlsfenster mit Standardwerten

.\DesktopAnalyticsLogsCollector.ps1

Beispiel 2: Ausführen eines Skripts über das PowerShell-Befehlsfenster mit angegebenen Parametern

.\DesktopAnalyticsLogsCollector.ps1 -LogPath "c:\testABC" -LogMode 0 -CollectNetTrace 0 -CollectUTCTrace 0

Beispiel 3: Ausführen eines Skripts über das PowerShell-Befehlsfenster mit angegebenen Parametern an der Position

.\DesktopAnalyticsLogsCollector.ps1 "c:\testABC" 2 0 0

Beispiel 4: Ausführen eines Skripts über das PowerShell-Befehlsfenster mit angegebenem Parameter und ausführlichen Meldungen

.\DesktopAnalyticsLogsCollector.ps1 -LogMode 1 -Verbose

Beispiel 5: Bereitstellen eines Skripts über Configuration Manager-Skripts

Weitere Informationen finden Sie unter Erstellen und Ausführen von PowerShell-Skripts über die Configuration Manager-Konsole.

DesktopAnalyticsLogsCollector.ps1 wird von Microsoft digital signiert. Möglicherweise müssen Sie das Microsoft Codesignaturzertifikat als vertrauenswürdigen Herausgeber auf dem Zielgerät hinzufügen.

  1. Öffnen Sie die Eigenschaften des Skripts in Windows Explorer. Wechseln Sie zur Registerkarte Digitale Signaturen, und wählen Sie Details aus.

  2. Wählen Sie auf der Registerkarte Allgemeindie Option Zertifikat anzeigen aus.

    Hinweis

    Um das Zertifikat über andere Mechanismen zu verteilen, exportieren Sie das Zertifikat zuerst in eine Datei. Wechseln Sie zur Registerkarte Details , und wählen Sie In Datei kopieren aus.

  3. Wählen Sie Zertifikat installieren. Importieren Sie das Zertifikat, und platzieren Sie es im Speicher für vertrauenswürdige Herausgeber .

Nächste Schritte