Ein Feature-Update oder In-Place-Upgrade bricht ab, und die Setup-Logs sind hunderte Seiten lang. SetupDiag durchsucht sie automatisch nach bekannten Fehlermustern – und ist heute direkt in Windows integriert.
Schlägt ein Windows-Upgrade fehl, beginnt die Suche in den Setup-Protokollen. Die sind umfangreich und über mehrere Ordner verteilt. 2018 haben wir in der Community auf ein Werkzeug hingewiesen, das diese Arbeit erheblich erleichtert: SetupDiag.
Was SetupDiag macht
SetupDiag wendet eine Sammlung von Regeln auf die Setup-Protokolle an. Jede Regel erkennt ein bekanntes Fehlermuster – etwa inkompatible Treiber, zu wenig Speicherplatz, blockierende Anwendungen oder Probleme beim Rollback. Das Ergebnis ist eine kompakte Zusammenfassung mit Fehlercode, Ursache und oft einem Lösungsvorschlag. Microsoft erweitert die Regeln mit jeder Version.
Durchsucht werden unter anderem:
C:\$Windows.~bt\Sources\Panther
C:\$Windows.~bt\Sources\Rollback
C:\Windows\Panther
C:\Windows\Panther\NewOS
Zwei Betriebsarten
- Online: Direkt auf dem betroffenen Gerät ausführen.
- Offline: Die Protokollordner auf einen anderen Rechner kopieren und SetupDiag dort mit dem Parameter für den Logpfad starten – praktisch, wenn das Gerät nicht mehr zugänglich ist oder viele Fälle zentral ausgewertet werden sollen.
SetupDiag.exe /Output:C:\Analyse\Ergebnis.log /LogsPath:D:\Logs\PC0815
Heute: direkt in Windows integriert
Seit Windows 10 Version 2004 ist SetupDiag Bestandteil des Windows-Setups. Schlägt ein Upgrade fehl, läuft die Analyse automatisch. Die Ergebnisse finden Sie anschließend:
- als Datei unter
%windir%\Logs\SetupDiag\SetupDiagResults.xml, - in der Registry unter
HKLM\SYSTEM\Setup\SetupDiag\Results.
Gerade der Registry-Schlüssel ist für die Massenauswertung interessant: Per Hardwareinventur von Configuration Manager, Intune-Skript oder PowerShell-Remoting lassen sich die Ergebnisse vieler Geräte zentral einsammeln.
Tipp
Sammeln Sie die SetupDiag-Ergebnisse aller Pilotgeräte eines Feature-Update-Rollouts. Häufen sich bestimmte Fehler, erkennen Sie Probleme – etwa einen veralteten Treiber eines Hardwaremodells –, bevor der breite Rollout beginnt.
Heute
SetupDiag wird weiterhin gepflegt und unterstützt auch Windows-11-Upgrades. Die eigenständige Version steht zusätzlich zum Download bereit, etwa für die Offline-Analyse.