Windows Update for Business-Berichte: Verwenden des Konfigurationsskripts zur Problembehandlung bei der Gerätekonfiguration

2025-01-15

Gilt für: Windows Server, alle unterstützten Versionen

Bei der Problembehandlung können Sie das Konfigurationsskript für Windows Update for Business-Berichte verwenden, um die Endpunktkonnektivität zu testen, sicherzustellen, dass die richtigen Dienste ausgeführt werden, und nach häufig auftretenden Problemen suchen.

Sie können das Skript aus dem Microsoft Download Center herunterladen.

Weitere Informationen zum Skript, einschließlich der verfügbaren Parameter, finden Sie unter Konfigurieren von Geräten über das Konfigurationsskript für Windows Update for Business-Berichte.

Notiz

Wenn Sie keine Probleme in der Gerätekonfiguration finden und feststellen, dass die Windows Update for Business-Berichte ordnungsgemäß konfiguriert sind, hängt ihr Problem wahrscheinlich mit der Datenübertragung zusammen. Weitere Informationen finden Sie in Windows Update for Business-Berichten: Problembehandlung bei der Diagnosedatenübermittlung.

Konfigurieren des Skripts

Das Gerät muss Windows 10 oder eine höhere Version und die neueste Version von Windows PowerShell installiert haben. Zum Ausführen des Skripts müssen Sie ein PowerShell-Fenster mit erhöhten Rechten auf dem Gerät verwenden (das Skript selbst wird im Systemkontext ausgeführt).

Wichtig

Das Skriptpaket enthält PSExec.exe. Wenn Sie einen Manager für mobile Geräte wie Microsoft Intune verwenden und ASR-Regeln (Attack Surface Reduction) über die standardmäßigen ASR-Regeln hinaus implementiert haben, können die Regeln das Skript blockieren. Weitere Informationen finden Sie unter Blockieren von Prozesserstellungen, die von PSExec- und WMI-Befehlen stammen.
Nachdem Sie die Problembehandlung für das Gerät abgeschlossen haben, entfernen Sie PSExec.exe.

Ausführen des Skripts

So verwenden Sie das Skript zur Problembehandlung für ein Clientgerät:

Melden Sie sich als Administrator beim Gerät an.
Laden Sie das Skriptpaket auf das Gerät herunter, das Sie behandeln möchten, und erweitern Sie das Skriptpaket.
Erstellen Sie einen Ordner auf dem Gerät für Protokolldaten. Der standardname und der pfad, den das Skript verwendet, ist *Der Standardwert ist .\UCLogs.
Bearbeiten Sie RunConfig.bat , um die folgenden erforderlichen Parameter festzulegen:
- runMode=Pilot
- logPath=<path of the folder that you created for log data>
Notiz
- Der Pilotmodus ist ein ausführlicher Modus. Das Skript verfügt über einen anderen Modus( Bereitstellung), der im Hintergrund ausgeführt wird.
- Ändern Sie die Commercial ID Parameter nicht. Sie werden für die frühere Version von Windows Update for Business-Berichten (Update Compliance) verwendet.

Wenn Sie zusätzliche Parameter festlegen möchten, sind die folgenden RunConfig.bat Parameter optional.

Parameter	Zulässige Werte und Beschreibung	Beispiel
logMode	0: Melden Sie sich nur bei der Konsole an. 1: (Standard) Protokoll in Datei und Konsole. 2: Melden Sie sich nur bei der Datei an.	`logMode=2`
DeviceNameOptIn	true: (Standard) Gerätename wird an Microsoft gesendet. false: Der Gerätename wird nicht an Microsoft gesendet.	`DeviceNameOptIn=true`
ClientProxy	Direct: (Standard) Das Gerät stellt eine direkte Verbindung mit den Endpunkten bereit. System: Das Gerät stellt eine Verbindung mithilfe eines Systemproxys ohne Authentifizierung bereit. Benutzer: Das Gerät stellt mithilfe der Internetkonfiguration des Benutzerkontos eine Verbindung herstellt. Die Verbindung erfordert möglicherweise keine Benutzerauthentifizierung. Weitere Informationen finden Sie unter Ermitteln des Windows Update-Clients, welcher Proxyserver für die Verbindung mit der Windows Update-Website verwendet werden soll.	`ClientProxy=Direct`

Speichern Sie die Änderungen an RunConfig.bat, und schließen Sie die Datei.
Öffnen Sie ein PowerShell-Fenster mit erhöhten Rechten, navigieren Sie zu dem Ordner, der die Skriptdateien enthält, und führen Sie dann RunConfig.bat aus.

Überprüfen der Skriptausgabe

Das Skript erstellt einen Arbeitsordner in dem Ordner, den logPath Sie im Parameter in RunConfig.bat identifiziert haben. Der Standardordnername ist UA_yy_MM_dd_HH_mm_ss_GUID, wobei yy_MM_dd_HH_mm_ss das Datum und die Uhrzeit darstellt, zu dem Sie das Skript ausgeführt haben. Das Skript speichert alle Ausgabedateien und andere Diagnosedateien in diesem Arbeitsordner.

Analysieren der Skriptprotokolldatei und Fehlercodes

Die Skriptprotokolldatei, UA_yy_MM_dd_HH_mm_ss_GUID.txt, hat denselben Namen wie der Arbeitsordner. Sie sollten diese Datei zuerst überprüfen. Sie können die folgende Tabelle verwenden, um alle Fehlercodes zu interpretieren, die in der Datei aufgeführt sind.

Error	Beschreibung
1	Unerwarteter Fehler
12	CheckVortexConnectivity fehlgeschlagen, überprüfen Sie die Protokollausgabe auf weitere Informationen.
12	Unerwarteter Fehler beim Ausführen von CheckVortexConnectivity.
16	Der Neustart steht auf dem Gerät aus. Starten Sie das Gerät neu, und führen Sie das Skript erneut aus.
17	Unerwartete Ausnahme in CheckRebootRequired.
27	Kein Systemkonto.
30	Enterprise-Authentifizierungsproxy kann nicht deaktiviert werden. Dieser Registrierungswert muss 0 sein, damit UTC in einer authentifizierten Proxyumgebung ausgeführt wird.
34	Unerwartete Ausnahme beim Überprüfen der Proxyeinstellungen.
35	Unerwartete Ausnahme beim Überprüfen des Benutzerproxys.
37	Unerwartete Ausnahme beim Sammeln von Protokollen.
40	Unerwartete Ausnahme beim Überprüfen und Festlegen der Telemetrie.
41	Der Identitätswechsel des angemeldeten Benutzers ist nicht möglich.
42	Unerwartete Ausnahme beim Versuch, die Identität des angemeldeten Benutzers zu imitieren.
43	Unerwartete Ausnahme beim Versuch, die Identität des angemeldeten Benutzers zu imitieren.
44	Fehler beim Ausführen des CheckDiagTrack-Diensts.
45	DiagTrack.dll nicht gefunden.
50	Der DiagTrack-Dienst wird nicht ausgeführt.
51	Unerwartete Ausnahme beim Ausführen von Census.exe.
52	Census.exe konnte nicht gefunden werden.
54	Der Microsoft-Kontoanmeldungs-Assistent (MSA)-Dienst ist deaktiviert.
55	Fehler beim Erstellen eines neuen Registrierungspfads für SetDeviceNameOptIn.
56	Fehler beim Erstellen der Eigenschaft für "SetDeviceNameOptIn" im Registrierungspfad.
57	Fehler beim Aktualisieren des Werts für SetDeviceNameOptIn.
58	Unerwartete Ausnahme in SetDeviceNameOptIn.
59	Fehler beim Löschen der LastPersistedEventTimeOrFirstBoot-Eigenschaft im Registrierungspfad beim Versuch, OneSettings zu bereinigen.
60	Fehler beim Löschen des Registrierungsschlüssels beim Versuch, OneSettings zu bereinigen.
61	Unerwartete Ausnahme beim Versuch, OneSettings zu bereinigen.
62	AllowTelemetry-Registrierungsschlüssel ist nicht der richtige Typ von REG_DWORD.
63	AllowTelemetry ist nicht auf den entsprechenden Wert festgelegt und konnte vom Skript nicht festgelegt werden.
64	AllowTelemetry ist nicht der richtige Typ von REG_DWORD.
66	Fehler beim Überprüfen der UTC-Konnektivität und der letzten Uploads.
67	Unerwarteter Fehler beim Überprüfen des UTC-Konfigurationsdienstanbieters.
99	Das Gerät ist nicht Windows 10 oder Windows 11.
100	Das Gerät muss mit Microsoft Entra verbunden sein oder microsoft Entra hybrid eingebunden sein, um Windows Update for Business-Berichte zu verwenden.
101	Überprüfen Sie, ob der Microsoft Entra-Beitritt mit unerwarteter Ausnahme fehlgeschlagen ist.
102	DisableOneSettingsDownloads-Richtlinie sollte nicht aktiviert sein. Deaktivieren Sie diese Richtlinie.

Analysieren der anderen Ausgabe- und Diagnosedaten

Diese Dateien erfassen Informationen, die das Skript aus der Registrierung exportiert.

RegAppCompatFlags.txt

Diese Datei zeichnet appraiser (manchmal auch als Device Appraiser oder Microsoft Compatibility Appraiser bezeichnet) Informationen auf. Appraiser ist die Windows-Komponente, die den Kompatibilitätsupdates entspricht. Es bewertet die Apps und Treiber auf dem Gerät auf Kompatibilität mit der neuesten Version von Windows. Appraiser hängt von den folgenden Dateien ab:

%windir%\System32\appraiser.dll. Die Dateiversion muss 10.0.17763 oder höher sein.
%windir%\System32\CompatTelRunner.exe. Wenn die Datei nicht vorhanden ist, stellen Sie sicher, dass alle Kompatibilitätsupdates auf dem Gerät installiert sind.

RegDataCollection.txt

Diese Datei zeichnet die DataCollection-Einstellungen auf. Diese Daten stellen die aktuelle Telemetriekonfiguration des Geräts pro angewendeten Richtlinien dar.

Sie können diese Daten verwenden, um zu überprüfen, ob die entsprechenden Werte angewendet werden, um Diagnosedaten an Microsoft zu übermitteln. Diese Daten ähneln dem folgenden Auszug:

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\DataCollection]
"AllowDeviceNameInTelemetry"=dword:00000001
"AllowUpdateComplianceProcessing"=dword:00000010
"AllowCommercialDataPipeline"=dword:00000001

RegPoliciesDataCollection.txt

Diese Datei zeichnet Einstellungen auf Geräteebene und Benutzerebene für die Steuerung von Diagnosedaten auf. Die Konfigurationsdaten auf Geräteebene ähneln dem folgenden Auszug:

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\DataCollection]
"AllowTelemetry"=dword:00000003
"MaxTelemetryAllowed"=dword:00000003

Der AllowTelemetry Eintrag steuert den Typ (falls vorhanden) der zu übertragenden Diagnosedaten. Der Eintrag hat die folgenden zulässigen Werte:

0 – Sicherheit (Dieser Wert wird nur für Enterprise-, Education- und Servereditionen von Windows unterstützt.)
1 – Grundlegende (erforderliche) Telemetrie
2 – Erweiterte Telemetrie
3 – Vollständige Telemetrie

Die Konfigurationsdaten auf Benutzerebene ähneln dem folgenden Auszug:

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\DataCollection\Users]

RegSQM.txt

Diese Informationen beziehen sich hauptsächlich auf Windows 7-Geräte. Wenn Sie in späteren Windows-Versionen arbeiten, können Sie diese Informationen als Fallback-ID für das Gerät verwenden.

RegDiagTrack.txt

Diese Datei zeichnet alle Registrierungseinstellungen für den Dienst "Benutzererfahrungen und Telemetrie im verbundenen Netzwerk " (DiagTrack) (UTC) auf. Alle Einträge, die diese Einstellungen speichern, befinden sich unter dem HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Diagnostics\DiagTrack\ Unterschlüssel. Der folgende Auszug zeigt einen solchen Bericht:

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Diagnostics\DiagTrack]
"TimeStampInterval"=dword:00000001
"Capabilities"=hex:c6,f6,43,15,00,00,00,00
"mspflags"=hex(b):11,00,00,00,00,00,00,00
"DiagTrackAuthorization"=dword:00000f9f
"LaunchCount"=hex(b):03,00,00,00,00,00,00,00
"DiagTrackStatus"=dword:00000003
"LastFreeNetworkLossTime"=hex(b):00,00,00,00,00,00,00,00
"LastConnectivityHeartBeatTime"=hex(b):00,00,00,00,00,00,00,00
"LastConnectivityState"=dword:00000002
"ConnectivityNoNetworkTime"=dword:00000001
"ConnectivityRestrictedNetworkTime"=dword:00000000
"LastPersistedEventTime"=hex(b):40,e5,64,27,cb,8a,d9,01
"LatencyDataLastUploadTime"=hex(b):00,00,00,00,00,00,00,00
"TriggerCount"=hex(b):00,04,00,00,00,00,00,00
"HttpRequestCount"=hex(b):07,00,00,00,00,00,00,00
"TriggerLatency"="0.088490"
"HttpRequestLatency"="0.077600"
"LastSuccessfulUploadTime"=hex(b):7a,96,6c,2b,cb,8a,d9,01
"LastSuccessfulRealtimeUploadTime"=hex(b):7a,96,6c,2b,cb,8a,d9,01
"LastSuccessfulNormalUploadTime"=hex(b):55,2a,aa,a7,ca,8a,d9,01

Verwenden des DCode-Tools zum Konvertieren von Hexadezimalwerten in das Datum-Uhrzeit-Format

Wie im vorherigen Auszug gezeigt, verwenden viele dieser Einträge das hexadezimale Big-End-Format. Um sie in UTC-Datums- und Uhrzeitangaben zu konvertieren, verwenden Sie ein Tool wie DCode. Dieses Tool steht als kostenloser Download zur Verfügung.

Das DCode-Tool verwendet Eingabewerte, die ein etwas anderes Format aufweisen als das, das von der Datei verwendet wird. Sie müssen die Reihenfolge der Segmente umkehren und dann alle nicht numerischen Zeichen entfernen. Betrachten Sie beispielsweise den folgenden Wert aus dem Auszug:

hex(b):55,2a,aa,a7,ca,8a,d9,01

Um diesen Wert zu konvertieren, öffnen Sie DCode, wählen Sie "Format" und dann "Hexadezimalwert( Big Endian)" aus. Geben Sie in "Wert" Folgendes ein:

01d98acaa7aa2a55

Wählen Sie dann "Decodieren" aus. Die Liste der Ergebnisse enthält einen Utc-Eintrag (Windows FileTime), der den Wert 2023-05-20 03:24:58.5114197 Z aufweist.