Diagnose van Windows 10 Upgrade-problemen met SetupDiag

De nieuwe supersnelle cadans van moderne Windows-versies en korte levenscyclus heeft gebruikers gedwongen om twee keer per jaar volledige OS-upgrades uit te voeren. De meest recente stabiele Windows 10-release op het moment van schrijven is bijvoorbeeld versie 1803, "April 2018 Update". Eind dit jaar verwachten we echter al versie 1809. Om gebruikers te helpen upgrades soepel uit te voeren, heeft Microsoft een nieuw diagnostisch hulpprogramma uitgebracht, SetupDiag.

De upgradeprocedure voor Windows 10 kan problemen opleveren, waardoor de installatie van een nieuwe build onmogelijk is. Als u een Windows Insider in de Fast Ring bent, ontvangt u nieuwe builds veel sneller dan andere. Ze zijn van pre-release kwaliteit en kunnen ernstige problemen bevatten.

Wanneer Setup het besturingssysteem niet kan upgraden, geeft Windows een foutcode weer en wordt het proces beëindigd. Meer details zijn meestal te vinden in het setup-logboek. Helaas zijn deze logs niet gebruiksvriendelijk. Het is moeilijk om te lezen en te begrijpen wat er gaande is en de succesvolle evenementen eruit te filteren. Hiervoor kan de tool SetupDiag worden gebruikt.

SetupDiag.exe is een op zichzelf staand diagnostisch hulpprogramma dat kan worden gebruikt om details te verkrijgen over de reden waarom een ​​upgrade naar Windows 10 niet is gelukt.

SetupDiag werkt door de logbestanden van Windows Setup te onderzoeken. Het probeert deze logbestanden te ontleden om de hoofdoorzaak te bepalen van het niet bijwerken of upgraden van de computer naar Windows 10. SetupDiag kan worden uitgevoerd op de computer die niet kon worden bijgewerkt, of u kunt logboeken van de computer naar een andere locatie exporteren en SetupDiag in de offline modus uitvoeren.

SetupDiag kan worden gedownload van de volgende website:

Download Setup Diag

De tool ondersteunt de volgende parameters:

Parameter	Beschrijving
/?	Geeft interactieve hulp weer
/Output:	Met deze optionele parameter kunt u het uitvoerbestand voor resultaten specificeren. Hier vindt u wat SetupDiag heeft kunnen vaststellen. Alleen uitvoer in tekstformaat wordt ondersteund. UNC-paden werken, op voorwaarde dat de context waaronder SetupDiag wordt uitgevoerd toegang heeft tot het UNC-pad. Als het pad een spatie bevat, moet u het hele pad tussen dubbele aanhalingstekens plaatsen (zie het voorbeeldgedeelte hieronder). Standaard: Indien niet opgegeven, zal SetupDiag het bestand maken SetupDiagResults.log in dezelfde map waar SetupDiag.exe wordt uitgevoerd.
/Mode:	Met deze optionele parameter kunt u de modus specificeren waarin SetupDiag werkt: offline of online. Offline: vertelt SetupDiag om te werken met een set logbestanden die al zijn vastgelegd van een defect systeem. In deze modus kunt u overal uitvoeren waar u toegang heeft tot de logbestanden. In deze modus hoeft SetupDiag niet te worden uitgevoerd op de computer die niet kon worden bijgewerkt. Wanneer u de offline modus opgeeft, moet u ook de parameter /LogsPath: opgeven. Online: vertelt SetupDiag dat het wordt uitgevoerd op de computer die niet kon worden bijgewerkt. SetupDiag zal proberen logbestanden en bronnen te vinden op standaard Windows-locaties, zoals de %SystemDrive%$Windows.~bt directory voor setup-logbestanden. Zoekpaden voor logbestanden kunnen worden geconfigureerd in het bestand SetupDiag.exe.config onder de SearchPath-sleutel. Zoekpaden worden door komma's gescheiden. Opmerking: een groot aantal zoekpaden verlengt de tijd die SetupDiag nodig heeft om resultaten te retourneren. Standaard: Indien niet opgegeven, wordt SetupDiag uitgevoerd in de onlinemodus.
/LogsPath:	Deze optionele parameter is alleen vereist wanneer: /Modus: Offline is gespecificeerd. Dit vertelt SetupDiag.exe waar de logbestanden te vinden zijn. Deze logbestanden kunnen de indeling van een platte map hebben of meerdere submappen bevatten. SetupDiag zoekt recursief in alle onderliggende mappen. Deze parameter moet worden weggelaten wanneer de /Modus: Online is gespecificeerd.
/ZipLogs:	Deze optionele parameter vertelt SetupDiag.exe om een ​​zip-bestand te maken met de resultaten en alle logbestanden die het heeft geparseerd. Het zipbestand wordt gemaakt in dezelfde map waarin SetupDiag.exe wordt uitgevoerd. Standaard: Indien niet opgegeven, wordt de waarde 'true' gebruikt.
/Verbose	Deze optionele parameter voert veel meer gegevens uit naar het logbestand dat wordt geproduceerd door SetupDiag.exe. Standaard zal SetupDiag alleen een logbestandsvermelding produceren voor ernstige fouten. Gebruik makend van /Verbose zorgt ervoor dat SetupDiag altijd een logbestand met debug-details produceert, wat handig kan zijn bij het melden van een probleem met SetupDiag.

Als uw build-upgrade is mislukt, voert u het hulpprogramma uit en bekijkt u het bestand SetupDiagResults.log in dezelfde map waarin SetupDiag is opgeslagen.

U kunt de locatie van het logbestand opgeven met behulp van het argument Uitvoer:

SetupDiag.exe /Output: C:\SetupDiag\Results.log /Mode: Online

U kunt ook de locatie van de Windows-logboeken overschrijven (bijvoorbeeld om de logboeken van een niet-botbaar besturingssysteem te analyseren) als volgt:

SetupDiag.exe /Output: C:\SetupDiag\Results.log /Mode: Offline /LogsPath: D:\Temp\Logs\LogSet1. 

Afhankelijk van wanneer de upgrade is mislukt, kopieert u een van de volgende mappen naar uw offline locatie:

\$Windows.~bt\sources\panther
\$Windows.~bt\Bronnen\Rollback
\Windows\Panther
\Windows\Panther\NewOS

Het volgende voorbeeld laat zien dat het logboek van SetupDiag is gestart in de offline modus. In dit voorbeeld is er een applicatiewaarschuwing, maar aangezien de setup wordt uitgevoerd in de /quiet-modus, wordt het een blok. Instructies om het probleem op te lossen worden geleverd door SetupDiag in de uitvoer.

C:\SetupDiag>SetupDiag.exe /Output: C:\SetupDiag\Results.log /Mode: Offline /LogsPath: C:\Temp\BobMacNeill SetupDiag v1.01. Auteursrecht (c) Microsoft Corporation. Alle rechten voorbehouden Zoeken naar setup-logs, dit kan een minuut of langer duren, afhankelijk van het aantal en de grootte van de logs... even geduld. Er zijn 4 setupact.logs gevonden. Setupact.log verwerken op: c:\temp\bobmacneill\$WINDOWS.~BT\Sources\Panther\setupact.log Setupact.log verwerken op: c:\temp\bobmacneill\Panther\setupact.log Setupact.log verwerken op: c:\temp\bobmacneill\Panther\NewOs\Panther\setupact.log Setupact.log verwerken op: c:\temp\bobmacneill\Panther\UnattendGC\setupact.log. Gevonden c:\temp\bobmacneill\$WINDOWS.~BT\Sources\Panther\setupact.log met updatedatum 29-03-2018 23:13:58 en CV: H2X+YsWL/UOkj/8X als het juiste installatielogboek. Informatie verzamelen uit installatielogboeken. SetupDiag: verwerkingsregel: CompatScanOnly. ..Geen match. SetupDiag: verwerkingsregel: BitLockerHardblock. ..Geen match. SetupDiag: verwerkingsregel: VHDHardblock. ..Geen match. SetupDiag: verwerkingsregel: PortableWorkspaceHardblock. ..Geen match. SetupDiag: verwerkingsregel: AuditModeHardblock. ..Geen match. SetupDiag: verwerkingsregel: SafeModeHardblock. ..Geen match. SetupDiag: verwerkingsregel: InsufficientSystemPartitionDiskSpaceHardblock. ..Geen match. SetupDiag: verwerkingsregel: CompatBlockedApplicationAutoUninstall. ...Geen match. SetupDiag: verwerkingsregel: CompatBlockedApplicationDismissable... Overeenkomend profiel gevonden: CompatBlockedApplicationDismissable - EA52620B-E6A0-4BBC-882E-0686605736D9. Waarschuwing: Applicatieblokkering gevonden voor: "Microsoft Endpoint Protection". Dit is een verwijderbaar bericht wanneer setup.exe niet in "/quiet"-modus wordt uitgevoerd. Overweeg om "/compat /ignore warning" op te geven om deze verwijderbare waarschuwingen te negeren. U moet "Microsoft Endpoint Protection" handmatig verwijderen voordat u doorgaat met de installatie/update, of de opdrachtregelparameters wijzigen om waarschuwingen te negeren. Zie hier voor meer informatie over Setup-opdrachtregelopties: https://docs.microsoft.com/en-us/windows-hardware/manufacture/desktop/windows-setup-command-line-options SetupDiag: verwerkingsregel: CompatBlockedApplicationManualUninstall. ...Geen match. SetupDiag: verwerkingsregel: HardblockDeviceOrDriver. ...Geen match. SetupDiag: verwerkingsregel: HardblockMismatchedLanguage. ..Geen match. SetupDiag: verwerkingsregel: HardblockFlightSigning. ..Geen match. SetupDiag: verwerkingsregel: DiskSpaceBlockInDownLevel. ..Geen match. SetupDiag: verwerkingsregel: DiskSpaceFailure. ..Geen match. SetupDiag: verwerkingsregel: DebugSetupMemoryDump. .Geen match. SetupDiag: verwerkingsregel: DebugSetupCrash. .Geen match. SetupDiag: verwerkingsregel: DebugMemoryDump. .Geen match. SetupDiag: verwerkingsregel: DeviceInstallHang. ..Geen match. SetupDiag: verwerkingsregel: BootFailureDetected. .Geen match. SetupDiag: verwerkingsregel: FindDebugInfoFromRollbackLog. .Geen match. SetupDiag: verwerkingsregel: AdvancedInstallerFailed. ..Geen match. SetupDiag: verwerkingsregel: FindMigApplyUnitFailure. ..Geen match. SetupDiag: verwerkingsregel: FindMigGatherUnitFailure. ..Geen match. SetupDiag: verwerkingsregel: OptionalComponentInstallFailure. ..Geen match. SetupDiag: verwerkingsregel: CriticalSafeOSDUFailure. ..Geen match. SetupDiag: verwerkingsregel: UserProfileCreationFailureDuringOnlineApply. ..Geen match. SetupDiag: verwerkingsregel: WimMountFailure. ..Geen match. SetupDiag: verwerkingsregel: FindSuccessfulUpgrade. ..Geen match. SetupDiag: verwerkingsregel: FindSetupHostReportedFailure. ..Geen match. SetupDiag: verwerkingsregel: FindDownlevelFailure. ..Geen match. SetupDiag: verwerkingsregel: FindAbruptDownlevelFailure. ...Fout: SetupDiag meldt abrupte down-level-fout. Laatste bewerking: voltooien, fout: 0xC1900208 - 0x4000C. Foutgegevens: laatste bewerking: voltooien, fout: 0xC1900208 - 0x4000C. Verwijzen naar https://docs.microsoft.com/en-us/windows/deployment/upgrade/upgrade-error-codes voor foutinformatie. SetupDiag: verwerkingsregel: FindSetupPlatformFailedOperationInfo. ..Geen match. SetupDiag: verwerkingsregel: FindRollbackFailure. ..Geen match. SetupDiag heeft 2 overeenkomende problemen gevonden. Waarschuwing: Applicatieblokkering gevonden voor: "Microsoft Endpoint Protection". Dit is een verwijderbaar bericht wanneer setup.exe niet in "/quiet"-modus wordt uitgevoerd. Overweeg om "/compat /ignore warning" op te geven om deze verwijderbare waarschuwingen te negeren. U moet "Microsoft Endpoint Protection" handmatig verwijderen voordat u doorgaat met de installatie/update, of de opdrachtregelparameters wijzigen om waarschuwingen te negeren. Zie hier voor meer informatie over Setup-opdrachtregelopties: https://docs.microsoft.com/en-us/windows-hardware/manufacture/desktop/windows-setup-command-line-options. Fout: SetupDiag meldt abrupte down-level-fout. Laatste bewerking: voltooien, fout: 0xC1900208 - 0x4000C. Foutgegevens: laatste bewerking: voltooien, fout: 0xC1900208 - 0x4000C. Verwijzen naar https://docs.microsoft.com/en-us/windows/deployment/upgrade/upgrade-error-codes voor foutinformatie. SetupDiag-resultaten zijn vastgelegd in: c:\setupdiag\results.log. Logs ZipFile gemaakt op: c:\setupdiag\Logs_14.zip. 

Bron: docs.microsoft.com