Diagnose von Windows Update Fehlern und Fehlercodes mit SetupDiag

Probleme mit Windows Updates, Windows Upgrades oder auch Windows Neuinstallationen sind sicherlich die häufigsten und nervigsten Windows Anwenderprobleme.

Dies weiß auch Microsoft und versucht ständig, den Windows Upgrade zu verbessern. Hierzu zählt auch ein weiteres Tool mit dem Namen

SetupDiag

welches Updateprobleme untersuchen kann. SetupDiag ist ab Windows 10 Version 2004 standardmäßig bei Neuinstallationen dabei, Ihr könnt es aber auch jederzeit kostenlos direkt von Microsoft downloaden. Den SetupDiag Downloadlink findet Ihr am Ende dieses Beitrages.

Was ist SetupDiag

SetupDiag ist ein eigenständiges Windows Diagnosetool, mit dem Ihr Details könnt, warum ein Windows 10-Upgrade nicht erfolgreich war und es zu einem entsprechenden Upgrade Fehlercode kam.

Hier könnt Ihr Euch bei unserem Windows-FAQ Newsletter anmelden.

SetupDiag untersucht dabei die mitgeschriebenen Windows Setup-Protokolldateien und analysiert diese Windows Update Protokolldateien, um die Ursache für die Upgradeprobleme zu finden.

Während eines Windows Upgrades extrahiert das Windows Setup alle Quelldateien des Upgrades in das Windows Verzeichnis

%SystemDrive%$Windows.~bt\Sources.

Mit Windows 10 Version 2004 bzw. einer höheren Version wird das setupdiag.exe Tool auch automatisch in diesem Verzeichnis installiert. Die Windows 10 Versionen ab 2004 führen nach einem Windows Upgrade Problem auch automatisch SetupDiag aus, um den Grund für das Upgradeproblem zu finden.

Installationsanforderungen für SetupDiag

Solltet Ihr SetupDiag manuell downloaden und installieren, so müsst Ihr darauf achten, dass Ihr mindestens .Net Framework 4.6 installiert habt.

SetupDiag ausführen und Windows Upgrade Probleme finden

Die Ausführung vom SetupDiag Tool ist denkbar einfach. Ruft einfach eine Eingabeaufforderung mit Administrator Rechten auf und gebt anschließend einfach den Befehl

Setupdiag

ein. Anschließend beginnt SetupDiag sofort mit der Untersuchung der Windows Update Protokolldateien und stellt die Ergebnisse in der Eingabeaufforderung dar. Wir haben hier nachfolgend einmal eine Zusammenfassung einer solchen SetupDiag Untersuchung dargestellt.

Da die Liste der untersuchten Bereiche der Windows Upgrade Protokolldateien zum umfangreich ist, haben wir Euch hier nachfolgend einmal eine komplette SetupDiag Protokolldatei aufgelistet.

Microsoft Windows [Version 10.0.19041.685]
(c) 2020 Microsoft Corporation. Alle Rechte vorbehalten.

C:\WINDOWS\system32>SetupDiag

SetupDiag v1.6.0.0
Copyright (©) Microsoft Corporation. All rights reserved.

Searching for setup logs...
Found C:\Windows\Panther\setupact.log with update date 20.12.2020 18:44:44 to be the correct setup log.

Gathering baseline information from setup logs...

SetupDiag: processing rule: CompatScanOnly.
...No match.
SetupDiag: processing rule: PlugInComplianceBlock.
...No match.
SetupDiag: processing rule: BitLockerHardblock.
...No match.
SetupDiag: processing rule: VHDHardblock.
...No match.
SetupDiag: processing rule: PortableWorkspaceHardblock.
...No match.
SetupDiag: processing rule: AuditModeHardblock.
...No match.
SetupDiag: processing rule: SafeModeHardblock.
...No match.
SetupDiag: processing rule: InsufficientSystemPartitionDiskSpaceHardblock.
...No match.
SetupDiag: processing rule: CompatBlockedApplicationAutoUninstall.
...No match.
SetupDiag: processing rule: CompatBlockedApplicationDismissable.
...No match.
SetupDiag: processing rule: CompatBlockedApplicationManualUninstall.
...No match.
SetupDiag: processing rule: HardblockDeviceOrDriver.
...No match.
SetupDiag: processing rule: HardblockMismatchedLanguage.
..No match.
SetupDiag: processing rule: HardblockFlightSigning.
..No match.
SetupDiag: processing rule: DiskSpaceBlockInDownLevel.
..No match.
SetupDiag: processing rule: DiskSpaceFailure.
..No match.
SetupDiag: processing rule: PreReleaseWimMountDriverFound.
..No match.
SetupDiag: processing rule: DeviceInstallHang.
...No match.
SetupDiag: processing rule: BootFailureDetected.
.No match.
SetupDiag: processing rule: WinSetupBootFilterFailure.
.No match.
SetupDiag: processing rule: FindDebugInfoFromRollbackLog.
.No match.
SetupDiag: processing rule: AdvancedInstallerFailed.
..No match.
SetupDiag: processing rule: AdvancedInstallerGenericFailure.
..No match.
SetupDiag: processing rule: FindMigApplyUnitFailure.
..No match.
SetupDiag: processing rule: FindMigGatherUnitFailure.
...No match.
SetupDiag: processing rule: FindMigGatherApplyFailure.
..No match.
SetupDiag: processing rule: OptionalComponentFailedToGetOCsFromPackage.
..No match.
SetupDiag: processing rule: OptionalComponentOpenPackageFailed.
..No match.
SetupDiag: processing rule: OptionalComponentInitCBSSessionFailed.
..No match.
SetupDiag: processing rule: CriticalSafeOSDUFailure.
..No match.
SetupDiag: processing rule: UserProfileCreationFailureDuringOnlineApply.
..No match.
SetupDiag: processing rule: UserProfileCreationFailureDuringFinalize.
..No match.
SetupDiag: processing rule: WimMountFailure.
..No match.
SetupDiag: processing rule: WimMountDriverIssue.
..No match.
SetupDiag: processing rule: WimApplyExtractFailure.
..No match.
SetupDiag: processing rule: UpdateAgentExpanderFailure.
.No match.
SetupDiag: processing rule: FindFatalPluginFailure.
...No match.
SetupDiag: processing rule: MigrationAbortedDueToPluginFailure.
...No match.
SetupDiag: processing rule: DISMAddPackageFailed.
..No match.
SetupDiag: processing rule: DISMImageSessionFailure.
..No match.
SetupDiag: processing rule: DISMproviderFailure.
..No match.
SetupDiag: processing rule: SysPrepLaunchModuleFailure.
..No match.
SetupDiag: processing rule: UserProvidedDriverInjectionFailure.
..No match.

SetupDiag: processing rule: FindSuccessfulUpgrade.
..
SetupDiag reports successful upgrade found.
This appears to be a successful update as the last operation was: OOBEBoot and the result was: success

SetupDiag found 1 matching issue.

SetupDiag results were logged to: .\SetupDiagResults.log
Logs ZipFile created at: .\Logs.zip

C:\WINDOWS\system32>

SetupDiag Ergebnisse in Protokolldatei umleiten

Wenn Ihr die Ergebnisse des SetupDiag Tools in eine Textdatei umleiten möchtet, damit Ihr sie besser auswerten könnt, so solltet Ihr folgenden Befehl verwenden.

SetupDiag.exe /Output:C:\VERZEICHNIS\setupdiag.log / Mode: Online

Den Pfad bzw. den Verzeichnisnamen müsst Ihr natürlich entsprechend anpassen.

SetupDiag Parameter

SetupDiag verfügt natürlich noch über viele weitere Parameter, auf die wir im einzelnen nicht eingehen können. Wir haben Euch aber hier nachfolgend die aktuell verfügbaren SetupDiag Parameter aufgelistet.

/Output: [Vollständiger Pfad und Dateiname für die Ausgabeprotokolldatei] – Gibt den Namen und den Speicherort für die Ergebnisprotokolldatei an.
/LogsPath: [Vollständiger Pfad zu Protokollen] – Gibt den Speicherort der zu analysierenden Protokolle an. Standardmäßig wird das aktuelle System auf Protokolle überprüft.
/ZipLogs: [True | False] – Weist SetupDiag.exe an, eine Zip-Datei zu erstellen, die die Ergebnisse und alle analysierten Protokolldateien enthält. Der Standardwert ist true.
/Format: [xml | json] – Gibt das Ausgabeformat für Protokolldateien als XML oder JSON an. Wenn nicht angegeben, wird das Textformat TXT verwendet.
/Scenario: [Wiederherstellung] – Weist SetupDiag.exe an, Reset- und Wiederherstellungsprotokolle zu suchen und zu verarbeiten und Setup- / Upgrade-Protokolle zu ignorieren.
/Verbose – Erstellt im aktuellen Verzeichnis ein Diagnoseprotokoll mit Debugging-Informationen und Details zu SetupDiag.
/NoTel – Weist SetupDiag.exe an, keine Diagnosetelemetrie zu senden.
/RegPath – Weist SetupDiag.exe an, der Registrierung unter dem angegebenen Pfad Fehlerinformationen hinzuzufügen.
Registrierungspfade sollten mit HKEY_LOCAL_MACHINE oder HKEY_CURRENT_USER beginnen und auf der Höhenebene zugänglich sein, unter der SetupDiag ausgeführt wird.
/AddReg – Weist SetupDiag.exe an, der Registrierung auf dem ausführenden System Fehlerinformationen hinzuzufügen.
SetupDiag fügt der Registrierung standardmäßig nur im Online-Modus Fehlerinformationen hinzu.
Registrierungsdaten werden an HKEY_LOCAL_MACHINE\SYSTEM\Setup\MoSetup\Volatile\SetupDiag gesendet, sofern nicht anders angegeben.

SetupDiag ist ein wunderbares Tool um Windows Update Fehlercodes zu untersuchen oder auch Windows Installationen zu untersuchen, die nicht mehr komplett booten können und deren Bootvorgang immer in einem Bluescreen bzw. BSOD enden.