Collecteur de journaux Desktop AnalyticsDesktop Analytics log collector

À compter de Configuration Manager version 1906, servez-vous de l’outil DesktopAnalyticsLogsCollector.ps1 figurant dans le répertoire d’installation de Configuration Manager pour résoudre les problèmes d’inscription d’appareils liés à Desktop Analytics.Starting in Configuration Manager version 1906, use the DesktopAnalyticsLogsCollector.ps1 tool from the Configuration Manager install directory to help troubleshoot Desktop Analytics device enrollment issues. Il exécute certaines étapes de base de la résolution des problèmes, et regroupe les journaux appropriés dans un répertoire de travail unique.It runs some basic troubleshooting steps and collects the relevant logs into a single working directory. Vous pouvez partager ce contenu avec le support Microsoft.You can share this content with Microsoft support.

PrérequisPrerequisites

UtilisationUsage

Récupérez le script à partir du contenu d’installation de Configuration Manager : SMSSETUP\TOOLS\DesktopAnalyticsLogsCollector\DesktopAnalyticsLogsCollector.ps1Get the script from the Configuration Manager installation content: SMSSETUP\TOOLS\DesktopAnalyticsLogsCollector\DesktopAnalyticsLogsCollector.ps1

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

ParamètresParameters

-LogPath

Spécifie un chemin local ou UNC pour placer le journal et autres fichiers de sortie.Specifies a local or UNC path to put the log and other output files.

Valeurs :Values:

  • Chemin local (longueur maximale = 130), par exemple : c:\myfolderLocal path (maximum length = 130), for example: c:\myfolder

  • Chemin UNC (longueur maximale = 130), par exemple : \\myserver\myfolderUNC path (maximum length = 130), for example: \\myserver\myfolder

Type : ChaîneType: String

Position : 1Position: 1

Valeur par défaut : $Env:SystemDrive\M365AnalyticsLogs (Quand ce paramètre est Null, vide ou un espace blanc, le script crée le dossier M365AnalyticsLogs sous le lecteur système.)Default value: $Env:SystemDrive\M365AnalyticsLogs (When this parameter is null, empty, or white space, the script creates the M365AnalyticsLogs folder under the system drive.)

-LogMode

Spécifie le niveau de détail des journaux.Specifies the verbose level of the logs.

Valeurs :Values:

  • 0 : Journalise les messages de script dans la fenêtre de commande PowerShell uniquement.0: Log script messages to PowerShell command window only.

  • 1 : Journalise les messages de script dans le fichier journal sous le dossier de sortie et dans la fenêtre de commande PowerShell.1: Log script messages to both log file under the output folder and PowerShell command window.

  • 2 : Journalise les messages de script dans le fichier journal sous le dossier de sortie uniquement.2: Log script messages to log file under the output folder only.

Type : Int16Type: Int16

Position : 2Position: 2

Valeur par défaut : 1 (Journalise les messages de script dans le fichier journal et dans la fenêtre de commande PowerShell.)Default value: 1 (Log script messages to both log file and PowerShell command window.)

-CollectNetTrace

Spécifie si le script collecte la trace réseau.Specifies whether the script collects the network trace.

Valeurs :Values:

  • 0 : Ne pas activer la trace réseau.0: Don't enable the network trace.

  • 1 (toute valeur entière différente de zéro) : Activer la trace réseau et collecter les résultats.1 (any non-zero integer value): Enable network trace and collect results.

Type : Int16Type: Int16

Position : 3Position: 3

Valeur par défaut : 0 (Ne pas activer la trace réseau)Default value: 0 (Don't enable the network trace)

-CollectUTCTrace

Spécifie si le script collecte le suivi UTC Windows et exécute le diagnostic de la connectivité.Specifies whether the script collects the Windows UTC trace and run connectivity diagnosis.

Valeurs :Values:

  • 0 : Ne pas activer le suivi UTC ou exécuter le diagnostic de la connectivité.0: Don't enable the UTC trace or run connectivity diagnosis.

  • 1 (toute valeur entière différente de zéro) : Activer le suivi UTC, exécuter le diagnostic de la connectivité et collecter les résultats.1 (any non-zero integer value): Enable the UTC trace, run connectivity diagnosis, and collect results.

Type : Int16Type: Int16

Position : 4Position: 4

Valeur par défaut : 0 (Ne pas activer le suivi UTC ou exécuter le diagnostic de la connectivité)Default value: 0 (Don't enable the UTC trace or run connectivity diagnosis)

SortieOutput

Le script crée un dossier de travail sous le chemin spécifié.The script creates a working folder under the specified path. Par exemple, M365AnalyticsLogs_yy_MM_dd_HH_mm_ss.For example, M365AnalyticsLogs_yy_MM_dd_HH_mm_ss. Il place tous ses fichiers de sortie dans ce dossier de travail.It puts all its output files into this working folder.

Si vous autorisez le script à écrire dans un fichier journal , il en génère un dans le dossier de travail.If you enable the script to write to a log file, it generates one in the working folder. Par exemple, M365AnalyticsLogs_ yy_MM_dd_HH_mm_ss.txt.For example, M365AnalyticsLogs_ yy_MM_dd_HH_mm_ss.txt.

Le script génère également d’autres fichiers de diagnostics dans le dossier de travail.The script also generates other diagnostic files in the working folder. Par exemple :For example:

  • installedKBs.txt : liste des mises à jour Windows installées sur l’appareilinstalledKBs.txt: a list of Windows updates installed on the device
  • appcompat : données sur la compatibilité des applicationsappcompat: application compatibility data
  • Reg*.txt : série de fichiers contenant des données exportées à partir du Registre WindowsReg*.txt: a series of files with exported data from the Windows Registry

ExemplesExamples

Exemple 1 : Exécuter le script par le biais de la fenêtre de commande PowerShell avec les valeurs par défautExample 1: Run script via PowerShell command window with default values

.\DesktopAnalyticsLogsCollector.ps1

Exemple 2 : Exécuter le script par le biais de la fenêtre de commande PowerShell avec des paramètres spécifiésExample 2: Run script via PowerShell command window with specified parameters

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

Exemple 3 : Exécuter le script par le biais de la fenêtre de commande PowerShell avec des paramètres spécifiés à leur positionExample 3: Run script via PowerShell command window with specified parameters in position

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

Exemple 4 : Exécuter le script par le biais de la fenêtre de commande PowerShell avec des paramètres spécifiés et des messages détaillésExample 4: Run script via PowerShell command window with specified parameter and verbose messages

.\DesktopAnalyticsLogsCollector.ps1 -LogMode 1 -Verbose

Exemple 5 : Déployer le script par le biais de la fonctionnalité Scripts de Configuration ManagerExample 5: Deploy script via Configuration Manager Scripts

Pour plus d’informations, consultez Créer et exécuter des scripts PowerShell à partir de la console Configuration Manager.For more information, see Create and run PowerShell scripts from the Configuration Manager console.

DesktopAnalyticsLogsCollector.ps1 est signé numériquement par Microsoft.DesktopAnalyticsLogsCollector.ps1 is digitally signed by Microsoft. Vous devrez peut-être ajouter son certificat de signature de code Microsoft en tant qu’éditeur approuvé sur l’appareil cible.You may need to add its Microsoft code signing certificate as a Trusted Publisher on the target device.

  1. Ouvrez les propriétés du script dans l’Explorateur Windows.Open the properties of the script in Windows Explorer. Basculez vers l’onglet Signatures numériques et sélectionnez Détails.Switch to the Digital Signatures tab and select Details.

  2. Sous l’onglet Général, sélectionnez Afficher le certificat.On the General tab, select View Certificate.

    Notes

    Pour distribuer le certificat par le biais d’autres mécanismes, exportez-le d’abord dans un fichier.To distribute the certificate via other mechanisms, first export the certificate to a file. Accédez à l’onglet Détails et sélectionnez Copier dans un fichier.Go to the Details tab, and select Copy to File.

  3. Sélectionnez Installer le certificat.Select Install Certificate. Importez le certificat, en le plaçant dans le magasin Éditeurs approuvés.Import the certificate, placing it in the Trusted Publishers store.

Voir aussiSee also