Moduł zbierający dzienniki usługi Desktop AnalyticsDesktop Analytics log collector

Począwszy od Configuration Manager w wersji 1906, użyj narzędzia DesktopAnalyticsLogsCollector. ps1 z katalogu instalacyjnego Configuration Manager, aby ułatwić rozwiązywanie problemów z rejestracją urządzeń w usłudze 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. Wykonuje on pewne podstawowe kroki rozwiązywania problemów i zbiera odpowiednie dzienniki w jednym katalogu roboczym.It runs some basic troubleshooting steps and collects the relevant logs into a single working directory. Tę zawartość możesz udostępnić z pomocą techniczną firmy Microsoft.You can share this content with Microsoft support.

Wymagania wstępnePrerequisites

UżycieUsage

Pobierz skrypt z zawartości instalacji 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>

ParametryParameters

-LogPath

Określa ścieżkę lokalną lub UNC do umieszczania dziennika i innych plików wyjściowych.Specifies a local or UNC path to put the log and other output files.

Wartości:Values:

  • Ścieżka lokalna (maksymalna długość = 130), na przykład:c:\myfolderLocal path (maximum length = 130), for example: c:\myfolder

  • Ścieżka UNC (maksymalna długość = 130), na przykład:\\myserver\myfolderUNC path (maximum length = 130), for example: \\myserver\myfolder

Typ: ciągType: String

Pozycja: 1Position: 1

Wartość domyślna: $Env:SystemDrive\M365AnalyticsLogs (gdy ten parametr ma wartość null, jest pusty lub biały znak, skrypt tworzy folder M365AnalyticsLogs w obszarze dysku systemowego).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

Określa poziom szczegółowości dzienników.Specifies the verbose level of the logs.

Wartości:Values:

  • 0: Komunikaty skryptu dziennika do okna poleceń programu PowerShell.0: Log script messages to PowerShell command window only.

  • 1: Rejestruj komunikaty skryptu do obu plików dziennika w folderze wyjściowym i oknie poleceń programu PowerShell.1: Log script messages to both log file under the output folder and PowerShell command window.

  • 2: Rejestruj komunikaty skryptu w pliku dziennika tylko w folderze danych wyjściowych.2: Log script messages to log file under the output folder only.

Typ: Int16Type: Int16

Pozycja: 2Position: 2

Wartość domyślna: 1 (Rejestruj komunikaty skryptu do obu plików dziennika i okna poleceń programu PowerShell).Default value: 1 (Log script messages to both log file and PowerShell command window.)

-CollectNetTrace

Określa, czy skrypt zbiera dane śledzenia sieci.Specifies whether the script collects the network trace.

Wartości:Values:

  • 0: Nie należy włączać śledzenia sieci.0: Don't enable the network trace.

  • 1(dowolna wartość różna od zera): Włącz śledzenie sieci i zbieraj wyniki.1 (any non-zero integer value): Enable network trace and collect results.

Typ: Int16Type: Int16

Pozycja: 3Position: 3

Wartość domyślna: 0 (nie należy włączać śledzenia sieci)Default value: 0 (Don't enable the network trace)

-CollectUTCTrace

Określa, czy skrypt zbiera dane śledzenia UTC systemu Windows i uruchamia diagnostykę łączności.Specifies whether the script collects the Windows UTC trace and run connectivity diagnosis.

Wartości:Values:

  • 0: Nie należy włączać śledzenia UTC ani uruchamiać diagnostyki łączności.0: Don't enable the UTC trace or run connectivity diagnosis.

  • 1(dowolna wartość różna od zera): Włącz śledzenie UTC, Uruchom diagnostykę łączności i zbierz wyniki.1 (any non-zero integer value): Enable the UTC trace, run connectivity diagnosis, and collect results.

Typ: Int16Type: Int16

Pozycja: 4Position: 4

Wartość domyślna: 0 (nie włączaj śledzenia UTC ani nie uruchamiaj diagnostyki łączności)Default value: 0 (Don't enable the UTC trace or run connectivity diagnosis)

Dane wyjścioweOutput

Skrypt tworzy folder roboczy pod określoną ścieżką.The script creates a working folder under the specified path. Na przykład M365AnalyticsLogs_yy_MM_dd_HH_mm_ss.For example, M365AnalyticsLogs_yy_MM_dd_HH_mm_ss. Umieszcza wszystkie pliki wyjściowe w tym folderze roboczym.It puts all its output files into this working folder.

Włączenie skryptu do zapisu w pliku dziennikaspowoduje jego wygenerowanie w folderze roboczym.If you enable the script to write to a log file, it generates one in the working folder. Na przykład M365AnalyticsLogs_ yy_MM_dd_HH_mm_ss. txt.For example, M365AnalyticsLogs_ yy_MM_dd_HH_mm_ss.txt.

Skrypt generuje również inne pliki diagnostyczne w folderze roboczym.The script also generates other diagnostic files in the working folder. Przykład:For example:

  • installedKBs.txt: Lista aktualizacji systemu Windows zainstalowanych na urządzeniuinstalledKBs.txt: a list of Windows updates installed on the device
  • appcompat: dane zgodności aplikacjiappcompat: application compatibility data
  • Reg*.txt: Seria plików z wyeksportowanymi danymi z rejestru systemu WindowsReg*.txt: a series of files with exported data from the Windows Registry

PrzykładyExamples

Przykład 1. Uruchamianie skryptu za pomocą okna poleceń programu PowerShell z wartościami domyślnymiExample 1: Run script via PowerShell command window with default values

.\DesktopAnalyticsLogsCollector.ps1

Przykład 2. Uruchamianie skryptu za pomocą okna poleceń programu PowerShell z określonymi parametramiExample 2: Run script via PowerShell command window with specified parameters

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

Przykład 3: uruchamianie skryptu za pośrednictwem okna poleceń programu PowerShell z określonymi parametrami na pozycjiExample 3: Run script via PowerShell command window with specified parameters in position

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

Przykład 4: uruchamianie skryptu za pośrednictwem okna poleceń programu PowerShell z określonym parametrem i pełnymi komunikatamiExample 4: Run script via PowerShell command window with specified parameter and verbose messages

.\DesktopAnalyticsLogsCollector.ps1 -LogMode 1 -Verbose

Przykład 5: wdrażanie skryptu za pomocą skryptów Configuration ManagerExample 5: Deploy script via Configuration Manager Scripts

Aby uzyskać więcej informacji, zobacz Tworzenie i uruchamianie skryptów programu PowerShell z poziomu konsoli Configuration Manager.For more information, see Create and run PowerShell scripts from the Configuration Manager console.

DesktopAnalyticsLogsCollector. ps1 jest podpisany cyfrowo przez firmę Microsoft.DesktopAnalyticsLogsCollector.ps1 is digitally signed by Microsoft. Może być konieczne dodanie swojego certyfikatu podpisywania kodu firmy Microsoft jako zaufanego wydawcę na urządzeniu docelowym.You may need to add its Microsoft code signing certificate as a Trusted Publisher on the target device.

  1. Otwórz właściwości skryptu w Eksploratorze Windows.Open the properties of the script in Windows Explorer. Przejdź do karty podpisy cyfrowe i wybierz pozycję szczegóły.Switch to the Digital Signatures tab and select Details.

  2. Na karcie Ogólne wybierz pozycję Wyświetl certyfikat.On the General tab, select View Certificate.

    Uwaga

    Aby dystrybuować certyfikat za pośrednictwem innych mechanizmów, najpierw wyeksportuj certyfikat do pliku.To distribute the certificate via other mechanisms, first export the certificate to a file. Przejdź do karty szczegóły , a następnie wybierz pozycję Kopiuj do pliku.Go to the Details tab, and select Copy to File.

  3. Wybierz pozycję Zainstaluj certyfikat.Select Install Certificate. Zaimportuj certyfikat, umieszczając go w magazynie zaufanych wydawców .Import the certificate, placing it in the Trusted Publishers store.

Zobacz teżSee also