Desktop Analytics agente di raccolta log

  • Articolo

Usare lo strumento DesktopAnalyticsLogsCollector.ps1 dalla directory di installazione Configuration Manager per risolvere Desktop Analytics problemi di registrazione dei dispositivi. Esegue alcuni passaggi di risoluzione dei problemi di base e raccoglie i log pertinenti in una singola directory di lavoro. È possibile condividere questo contenuto con Microsoft supporto.

Prerequisiti

Utilizzo

Ottenere lo script dal contenuto di installazione Configuration Manager:SMSSETUP\TOOLS\DesktopAnalyticsLogsCollector\DesktopAnalyticsLogsCollector.ps1

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

Parametri

-LogPath

Specifica un percorso locale o UNC per inserire il log e altri file di output.

Valori:

  • Percorso locale (lunghezza massima = 130), ad esempio: c:\myfolder

  • Percorso UNC (lunghezza massima = 130), ad esempio: \\myserver\myfolder

Tipo: Stringa

Posizione: 1

Valore predefinito: $Env:SystemDrive\M365AnalyticsLogs quando questo parametro è null, vuoto o spazio vuoto, lo script crea la cartella M365AnalyticsLogs nell'unità di sistema.

-LogMode

Specifica il livello dettagliato dei log.

Valori:

  • 0: registra i messaggi script solo nella finestra di comando di PowerShell.

  • 1: registrare i messaggi di script in entrambi i file di log nella cartella di output e nella finestra di comando di PowerShell.

  • 2: registra i messaggi script nel file di log solo nella cartella di output.

Tipo: Int16

Posizione: 2

Valore predefinito: 1 (Registra i messaggi di script sia nel file di log che nella finestra di comando di PowerShell).

-CollectNetTrace

Specifica se lo script raccoglie la traccia di rete.

Valori:

  • 0: non abilitare la traccia di rete.

  • 1 (qualsiasi valore intero diverso da zero): abilitare la traccia di rete e raccogliere i risultati.

Tipo: Int16

Posizione: 3

Valore predefinito: 0 (Non abilitare la traccia di rete)

-CollectUTCTrace

Specifica se lo script raccoglie la traccia UTC di Windows ed esegue la diagnosi della connettività.

Valori:

  • 0: non abilitare la traccia UTC o eseguire la diagnosi della connettività.

  • 1 (qualsiasi valore intero diverso da zero): abilitare la traccia UTC, eseguire la diagnosi della connettività e raccogliere i risultati.

Tipo: Int16

Posizione: 4

Valore predefinito: 0 (non abilitare la traccia UTC o eseguire la diagnosi della connettività)

Output

Lo script crea una cartella di lavoro nel percorso specificato. Ad esempio, M365AnalyticsLogs_yy_MM_dd_HH_mm_ss. Inserisce tutti i file di output in questa cartella di lavoro.

Se si abilita lo script per la scrittura in un file di log, ne viene generato uno nella cartella di lavoro. Ad esempio, M365AnalyticsLogs_ yy_MM_dd_HH_mm_ss.txt.

Lo script genera anche altri file di diagnostica nella cartella di lavoro. Ad esempio:

  • installedKBs.txt: elenco degli aggiornamenti di Windows installati nel dispositivo
  • appcompat: dati di compatibilità delle applicazioni
  • Reg*.txt: una serie di file con dati esportati dal Registro di sistema di Windows

Esempi

Esempio 1: Eseguire script tramite la finestra di comando di PowerShell con i valori predefiniti

.\DesktopAnalyticsLogsCollector.ps1

Esempio 2: Eseguire script tramite la finestra di comando di PowerShell con i parametri specificati

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

Esempio 3: Eseguire script tramite la finestra di comando di PowerShell con parametri specificati nella posizione

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

Esempio 4: Eseguire script tramite la finestra di comando di PowerShell con il parametro specificato e i messaggi dettagliati

.\DesktopAnalyticsLogsCollector.ps1 -LogMode 1 -Verbose

Esempio 5: Distribuire script tramite script Configuration Manager

Per altre informazioni, vedere Creare ed eseguire script di PowerShell dalla console di Configuration Manager.

DesktopAnalyticsLogsCollector.ps1 è firmato digitalmente da Microsoft. Potrebbe essere necessario aggiungere il relativo certificato di firma del codice Microsoft come autore attendibile nel dispositivo di destinazione.

  1. Aprire le proprietà dello script in Esplora risorse. Passare alla scheda Firme digitali e selezionare Dettagli.

  2. Nella scheda Generale selezionare Visualizza certificato.

    Nota

    Per distribuire il certificato tramite altri meccanismi, esportare prima di tutto il certificato in un file. Passare alla scheda Dettagli e selezionare Copia nel file.

  3. Selezionare Installa certificato. Importare il certificato, inserendolo nell'archivio autori attendibili .

Passaggi successivi