SetupDiag

À propos de SetupDiag

SetupDiag est un outil de diagnostic qui peut être utilisé pour obtenir des détails sur la raison de l’échec d’une mise à niveau Windows.

SetupDiag fonctionne en examinant les fichiers journaux d’installation de Windows. Il tente d’analyser ces fichiers journaux pour déterminer la cause racine d’un échec de mise à jour ou de mise à niveau de l’ordinateur vers Windows. SetupDiag peut être exécuté sur l’ordinateur qui n’a pas pu être mis à jour. Les journaux peuvent également être exportés de l’ordinateur vers un autre emplacement, puis en exécutant SetupDiag en mode hors connexion.

SetupDiag est inclus avec le programme d’installation de Windows dans toutes les versions de Windows actuellement prises en charge.

Pendant le processus de mise à niveau, le programme d’installation de Windows extrait tous ses fichiers sources, y compris SetupDiag.exe, dans le répertoire %SystemDrive%$Windows.~bt\Sources . En cas de problème avec la mise à niveau, SetupDiag s’exécute automatiquement pour déterminer la cause de l’échec.

Lorsqu’ils sont exécutés par le programme d’installation de Windows, les paramètres suivants sont utilisés :

• /ZipLogs :False
• /Format :xml
• /Output :%windir%\logs\SetupDiag\SetupDiagResults.xml
• /RegPath :HKEY_LOCAL_MACHINE\SYSTEM\Setup\SetupDiag\Results

L’analyse SetupDiag obtenue se trouve dans %WinDir%\Logs\SetupDiag\SetupDiagResults.xml et dans le Registre sous HKLM\SYSTEM\Setup\SetupDiag\Results.

Si le processus de mise à niveau se poursuit normalement, le répertoire Sources , y compris SetupDiag.exe , est déplacé sous %SystemDrive%\Windows.Old pour le nettoyage. Si le répertoire Windows.old est supprimé ultérieurement, SetupDiag.exe est également supprimé.

Conditions préalables

1. La version de destination de Windows doit être une version de Windows actuellement prise en charge. La version de Windows installée à l’origine peut être une version de Windows qui n’est plus prise en charge tant que :

   • La version de destination de Windows est une version de Windows actuellement prise en charge.
   • La mise à niveau vers la version de destination de Windows est prise en charge à partir de la version installée d’origine de Windows.

2. .NET Framework 4.7.2 ou version ultérieure doit être installé. Pour déterminer quelle version de .NET est préinstallée avec une version spécifique de Windows, consultez Configuration système requise pour .NET Framework : Systèmes d’exploitation clients pris en charge. Pour déterminer quelle version de .NET est actuellement installée, consultez Guide pratique pour déterminer quelles versions du .NET Framework sont installées.

   La requête de ligne de commande suivante peut être utilisée pour afficher la version de .NET actuellement installée :

   reg.exe query "HKLM\SOFTWARE\Microsoft\Net Framework Setup\NDP\v4" /s
   

   Tant qu’au moins la version requise de .NET est installée, aucune action supplémentaire n’est requise, notamment si une version plus récente est installée.

Utilisation de SetupDiag

Pour utiliser rapidement SetupDiag sur l’ordinateur actuel :

1. Vérifiez que le système répond à la configuration requise.

2. Téléchargez SetupDiag.

3. Si le navigateur web vous demande ce qu’il faut faire avec le fichier, choisissez Enregistrer. Par défaut, le fichier est enregistré dans le dossier Téléchargements . Si vous le souhaitez, le fichier peut également être enregistré à un autre emplacement à l’aide de l’option Enregistrer sous.

4. Une fois le téléchargement terminé, ouvrez le dossier dans lequel le fichier a été téléchargé. Par défaut, ce dossier est le dossier Téléchargements, qui s’affiche dans Explorateur de fichiers sous Accès rapide dans le volet de navigation gauche.

5. Double-cliquez sur le fichier SetupDiag pour l’exécuter. Sélectionnez Oui si vous êtes invité à approuver l’exécution du programme.

Double-cliquer sur le fichier pour l’exécuter ferme automatiquement la fenêtre de commande lorsque SetupDiag termine son analyse. Pour laisser la fenêtre ouverte pour passer en revue les messages générés par SetupDiag, exécutez le programme en tapant SetupDiag à l’invite de commandes au lieu de double-cliquer dessus. Lors de l’exécution à partir d’une invite de commandes, veillez à remplacer les répertoires par l’emplacement où se trouve SetupDiag.

1. Une fenêtre de commande s’ouvre pendant que SetupDiag diagnostique l’ordinateur. Attendez la fin de ce processus.

2. Une fois SetupDiag terminé, deux fichiers sont créés dans le même dossier à partir duquel SetupDiag a été exécuté. L’un est un fichier de configuration, l’autre est un fichier journal.

3. Utilisez le Bloc-notes pour ouvrir le fichier journal SetupDiagResults.log.

4. Passez en revue les informations affichées. Si une règle a été mise en correspondance, ces informations peuvent indiquer pourquoi l’ordinateur n’a pas réussi à mettre à niveau et éventuellement comment résoudre le problème. Consultez la section Exemple de journal de texte.

Pour obtenir des instructions sur l’exécution de l’outil en mode hors connexion et avec des options plus avancées, consultez les sections Paramètres et Exemples.

Parameters

Exemples

• Dans l’exemple suivant, SetupDiag est exécuté avec les paramètres par défaut en mode en ligne. Le fichier de résultats est SetupDiagResults.log dans le dossier où SetupDiag est exécuté.

  SetupDiag.exe
  

• Dans l’exemple suivant, SetupDiag est exécuté en mode en ligne (ce mode est le mode par défaut). Il sait où rechercher les journaux sur le système actuel (défaillant), il n’est donc pas nécessaire de collecter les journaux à l’avance. Un emplacement personnalisé pour les résultats est spécifié.

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

• L’exemple suivant utilise le paramètre /Output pour enregistrer les résultats dans un nom de chemin contenant un espace :

  SetupDiag /Output:"C:\Tools\SetupDiag\SetupDiag Results\Results.log"
  

• L’exemple suivant spécifie que SetupDiag doit s’exécuter en mode hors connexion et traiter les fichiers journaux trouvés dans D :\Temp\Logs\LogSet1.

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

• L’exemple suivant définit le scénario de récupération en mode hors connexion. Dans l’exemple, SetupDiag recherche les journaux de réinitialisation/récupération dans l’emplacement LogsPath spécifié et génère les résultats dans le répertoire spécifié par le paramètre /Output .

  SetupDiag.exe /Output:C:\SetupDiag\RecoveryResults.log /LogsPath:D:\Temp\Cabs\PBR_Log /Scenario:Recovery
  

• L’exemple suivant définit le scénario de récupération en mode en ligne. Dans l’exemple, SetupDiag recherche les journaux de réinitialisation/récupération sur le système actuel et les résultats de sortie au format XML.

  SetupDiag.exe /Scenario:Recovery /Format:xml
  

• L’exemple suivant est un exemple de mode hors connexion. SetupDiag est chargé d’analyser les fichiers journaux d’installation/de mise à niveau dans le répertoire LogsPath et de générer les résultats dans C:\SetupDiag\Results.txt.

  SetupDiag.exe /Output:C:\SetupDiag\Results.txt /LogsPath:D:\Temp\Logs\Logs1 /RegPath:HKEY_CURRENT_USER\SYSTEM\SetupDiag
  

• L’exemple suivant est un exemple de mode en ligne. SetupDiag est chargé de rechercher les journaux d’installation/mise à niveau sur le système actuel et de générer ses résultats au format XML vers C:\SetupDiag\Results.xml.

  SetupDiag.exe /Output:C:\SetupDiag\Results.xml /Format:xml
  

• L’exemple suivant est un exemple de mode en ligne où aucun paramètre n’est nécessaire ou utilisé. SetupDiag est chargé de rechercher les journaux d’installation/de mise à niveau sur le système actuel et de générer les résultats dans le répertoire où se trouve SetupDiag.

  SetupDiag.exe
  

• L’exemple suivant est un exemple de mode de réinitialisation/récupération hors connexion. SetupDiag est chargé de rechercher les journaux de réinitialisation/récupération à l’emplacement LogsPath spécifié. Il génère ensuite les résultats dans le répertoire spécifié par le paramètre /Output .

  SetupDiag.exe /Output:C:\SetupDiag\RecoveryResults.log /LogsPath:D:\Temp\Cabs\PBR_Log /Scenario:Recovery
  

• L’exemple suivant est un exemple de mode de réinitialisation/récupération en ligne. SetupDiag est chargé de rechercher les journaux de réinitialisation/récupération sur le système actuel et de générer ses résultats au format XML.

  SetupDiag.exe /Scenario:Recovery /Format:xml
  

Fichiers journaux

Les fichiers journaux d’installation de Windows et les journaux des événements disposent d’informations sur l’emplacement où les journaux sont créés pendant l’installation de Windows. Pour le traitement hors connexion, SetupDiag doit être exécuté sur le contenu du dossier entier. Par exemple, selon le moment où la mise à niveau a échoué, copiez l’un des dossiers suivants dans l’emplacement hors connexion :

• \$Windows.~bt\sources\panther
• \$Windows.~bt\Sources\Rollback
• \Windows\Panther
• \Windows\Panther\NewOS

Si le dossier parent et tous les sous-dossiers sont copiés, SetupDiag recherche automatiquement les fichiers journaux dans tous les sous-répertoires.

Analyse du case activée des bogues de configuration

Lorsque Microsoft Windows rencontre une condition qui compromet le fonctionnement sécurisé du système, le système s’arrête. Cette condition est appelée bogue case activée. Cette condition est également communément appelée incident du système, erreur de noyau, erreur d’arrêt ou BSOD. En règle générale, un périphérique matériel, un pilote matériel ou un logiciel associé provoque cette erreur.

Si les vidages sur incident sont activés sur le système, un fichier de vidage sur incident est créé. Si le bogue case activée se produit pendant une mise à niveau, le programme d’installation de Windows extrait un fichier minidump (setupmem.dmp). SetupDiag peut également déboguer ces minidumps liés à l’installation.

Pour déboguer un bogue lié à l’installation case activée :

• Spécifiez le paramètre /LogsPath . Les vidages de mémoire ne peuvent pas être débogués en mode en ligne.

• Rassemblez le fichier de vidage mémoire d’installation ('setupmem.dmp) à partir du système défaillant.

  Setupmem.dmpest créé dans %SystemDrive%$Windows.~bt\Sources\Rollback, ou dans %WinDir%\Panther\NewOS\Rollback selon le moment où le bogue case activée se produit.

• Installez les outils de débogage Windows sur l’ordinateur qui exécute SetupDiag.

Dans l’exemple suivant, le setupmem.dmp fichier est copié dans le D:\Dump répertoire et les outils de débogage Windows sont installés avant d’exécuter SetupDiag :

SetupDiag.exe /Output:C:\SetupDiag\Dumpdebug.log /LogsPath:D:\Dump

Problèmes connus

• Le traitement de certaines règles peut prendre beaucoup de temps si les fichiers journaux impliqués sont volumineux.

Exemple de sortie

La commande suivante est un exemple où SetupDiag est exécuté en mode hors connexion.

D:\SetupDiag>SetupDiag.exe /output:c:\setupdiag\result.xml /logspath:D:\Tests\Logs\f55be736-beed-4b9b-aedf-c133536c946e /format:xml

SetupDiag v1.7.0.0
Copyright (c) Microsoft Corporation. All rights reserved.

Searching for setup logs...
Found d:\tests\Logs\f55be736-beed-4b9b-aedf-c133536c946e\setupact_6.log with update date 6/12/2023 2:44:20 PM to be the correct setup log.
Found d:\tests\Logs\f55be736-beed-4b9b-aedf-c133536c946e\setupact_1.log with update date 6/12/2023 2:45:19 PM to be the correct rollback log.

Gathering baseline information from setup logs...

SetupDiag: processing rule: CompatScanOnly.
...No match.

...

SetupDiag: processing rule: DISMImageSessionFailure.
..
Error: SetupDiag reports DISM provider failure.
Last Phase: Safe OS
Last Operation: Apply Optional Component status
Message = Failed to get the IDismImage instance from the image session
Function: CDISMManager::CloseImageSession
Error: 0x800706ba
Recommend you re-download the update source files, reboot and try the update again.

SetupDiag found 1 matching issue.

SetupDiag results were logged to: c:\setupdiag\results.xml
Logs ZipFile created at: c:\setupdiag\Logs_14.zip

Règles

Lorsque SetupDiag recherche des fichiers journaux, il utilise un ensemble de règles pour correspondre aux problèmes connus. Ces règles sont contenues dans un fichier xml. Le fichier xml peut être mis à jour avec des règles nouvelles et mises à jour à mesure que de nouvelles versions de SetupDiag sont disponibles.

Chaque nom de règle et son identificateur de règle unique associé sont répertoriés avec une description du problème connu de blocage de mise à niveau. Dans les descriptions de règle, le terme de bas niveau fait référence à la première phase du processus de mise à niveau, qui s’exécute sous le système d’exploitation d’origine.

Exemples de journaux

Exemple de journal de texte

Matching Profile found: OptionalComponentOpenPackageFailed - 22952520-EC89-4FBD-94E0-B67DF88347F6
System Information:
    Machine Name = Offline
    Manufacturer = MSI
    Model = MS-7998
    HostOSArchitecture = x64
    FirmwareType = PCAT
    BiosReleaseDate = 20160727000000.000000+000
    BiosVendor = BIOS Date: 07/27/16 10:01:46 Ver: V1.70
    BiosVersion = 1.70
    HostOSVersion = 10.0.15063
    HostOSBuildString = 15063.0.amd64fre.rs2_release.170317-1834
    TargetOSBuildString = 10.0.16299.15 (rs3_release.170928-1534)
    HostOSLanguageId = 2057
    HostOSEdition = Core
    RegisteredAV = Windows Defender,
    FilterDrivers = WdFilter,wcifs,WIMMount,luafv,Wof,FileInfo,
    UpgradeStartTime = 3/21/2023 9:47:16 PM
    UpgradeEndTime = 3/21/2023 10:02:40 PM
    UpgradeElapsedTime = 00:15:24
    ReportId = dd4db176-4e3f-4451-aef6-22cf46de8bde

Error: SetupDiag reports Optional Component installation failed to open OC Package. Package Name: Foundation, Error: 0x8007001F
Recommend you check the "Windows Modules Installer" service (Trusted Installer) is started on the system and set to automatic start, reboot and try the update again.  Optionally, you can check the status of optional components on the system (search for Windows Features), uninstall any unneeded optional components, reboot and try the update again.
Error: SetupDiag reports down-level failure, Operation: Finalize, Error: 0x8007001F - 0x50015
Refer to https://zcusa.951200.xyz/windows/deployment/upgrade/upgrade-error-codes for error information.

Exemple de journal XML

<?xml version="1.0" encoding="utf-16"?>
<SetupDiag xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="https://zcusa.951200.xyz/windows/deployment/upgrade/setupdiag">
  <Version>1.7.0.0</Version>
  <ProfileName>FindSPFatalError</ProfileName>
  <ProfileGuid>A4028172-1B09-48F8-AD3B-86CDD7D55852</ProfileGuid>
  <SystemInfo>
    <MachineName>Offline</MachineName>
    <Manufacturer>Gigabyte Technology Co., Ltd.</Manufacturer>
    <Model>X470 AORUS ULTRA GAMING</Model>
    <HostOSArchitecture>1033</HostOSArchitecture>
    <FirmwareType>UEFI</FirmwareType>
    <BiosReleaseDate>20180808000000.000000+000</BiosReleaseDate>
    <BiosVendor>F3</BiosVendor>
    <BiosVersion />
    <HostOSVersion>10.0.18908</HostOSVersion>
    <HostOSBuildString>18908.1000.amd64fre.rs_prerelease.190524-1658</HostOSBuildString>
    <TargetOSBuildString>10.0.18912.1001 (rs_prerelease.190601-1739)</TargetOSBuildString>
    <HostOSLanguageId />
    <HostOSEdition>Professional</HostOSEdition>
    <RegisteredAV>Windows Defender</RegisteredAV>
    <FilterDrivers />
    <UpgradeStartTime>2023-06-06T21:19:10</UpgradeStartTime>
    <UpgradeElapsedTime />
    <UpgradeEndTime>2023-06-06T22:21:49</UpgradeEndTime>
    <RollbackStartTime>0001-01-01T00:00:00</RollbackStartTime>
    <RollbackEndTime>0001-01-01T00:00:00</RollbackEndTime>
    <RollbackElapsedTime />
    <FinalizeStartTime>0001-01-01T00:00:00</FinalizeStartTime>
    <PostOOBESuccessTime>0001-01-01T00:00:00</PostOOBESuccessTime>
    <TotalOfflineTime />
    <CommercialId>Offline</CommercialId>
    <CV>MgUweCZk90KdwUiZ</CV>
    <SetupReportId>F21F8FB6-00FD-4349-84FB-2AC75F389E73</SetupReportId>
    <ReportId>F21F8FB6-00FD-4349-84FB-2AC75F389E73</ReportId>
  </SystemInfo>
  <LogErrorLine>2023-06-06 21:47:11, Error                 SP     Error converting install time 5/2/2023 to structure[gle=0x00000057]</LogErrorLine>
  <FailureData>
Error: SetupDiag reports Fatal Error.
Last Setup Phase = Downlevel
Last Setup Operation: Gather data, scope: EVERYTHING
Error: 0x00000057</FailureData>
  <FailureData>LogEntry: 2023-06-06 21:47:11, Error                 SP     Error converting install time 5/2/2023 to structure[gle=0x00000057]</FailureData>
  <FailureData>LogEntry: 2023-06-06 21:47:11, Error                 SP     Error converting install time 5/2/2023 to structure[gle=0x00000057]</FailureData>
  <FailureData>
Refer to "https://zcusa.951200.xyz/windows/desktop/Debug/system-error-codes" for error information.</FailureData>
  <FailureDetails>Err = 0x00000057, LastOperation = Gather data, scope: EVERYTHING, LastPhase = Downlevel</FailureDetails>
</SetupDiag>

Exemple de journal JSON

{
    "Version":"1.6.0.0",
    "ProfileName":"FindSPFatalError",
    "ProfileGuid":"A4028172-1B09-48F8-AD3B-86CDD7D55852",
    "SystemInfo":{
        "BiosReleaseDate":"20180808000000.000000+000",
        "BiosVendor":"F3",
        "BiosVersion":"F3",
        "CV":"MgUweCZk90KdwUiZ",
        "CommercialId":"Offline",
        "FilterDrivers":"",
        "FinalizeStartTime":"\/Date(-62135568000000-0800)\/",
        "FirmwareType":"UEFI",
        "HostOSArchitecture":"x64",
        "HostOSBuildString":"18908.1000.amd64fre.rs_prerelease.190524-1658",
        "HostOSEdition":"Professional",
        "HostOSLanguageId":"",
        "HostOSVersion":"",
        "MachineName":"Offline",
        "Manufacturer":"Gigabyte Technology Co., Ltd.",
        "Model":"X470 AORUS ULTRA GAMING",
        "PostOOBESuccessTime":"\/Date(-62135568000000-0800)\/",
        "RegisteredAV":"Windows Defender",
        "ReportId":"F21F8FB6-00FD-4349-84FB-2AC75F389E73",
        "RollbackElapsedTime":"PT0S",
        "RollbackEndTime":"\/Date(-62135568000000-0800)\/",
        "RollbackStartTime":"\/Date(-62135568000000-0800)\/",
        "SetupReportId":"F21F8FB6-00FD-4349-84FB-2AC75F389E73",
        "TargetOSArchitecture":null,
        "TargetOSBuildString":"10.0.18912.1001 (rs_prerelease.190601-1739)",
        "TotalOfflineTime":"PT0S",
        "UpgradeElapsedTime":"PT1H2M39S",
        "UpgradeEndTime":"\/Date(1559884909000-0700)\/",
        "UpgradeStartTime":"\/Date(1559881150000-0700)\/"
    },
    "LogErrorLine":"2023-06-06 21:47:11, Error                 SP     Error converting install time 5\/2\/2023 to structure[
        gle=0x00000057
    ]",
    "FailureData":[
        "\u000aError: SetupDiag reports Fatal Error.\u000aLast Setup Phase = Downlevel\u000aLast Setup Operation: Gather data, scope: EVERYTHING\u000aError: 0x00000057",
        "LogEntry: 2023-06-06 21:47:11, Error                 SP     Error converting install time 5\/2\/2023 to structure[
            gle=0x00000057
        ]",
        "LogEntry: 2023-06-06 21:47:11, Error                 SP     Error converting install time 5\/2\/2023 to structure[
            gle=0x00000057
        ]",
        "\u000aRefer to \"https:\/\/zcusa.951200.xyz\/windows\/desktop\/Debug\/system-error-codes\" for error information."
    ],
    "FailureDetails":"Err = 0x00000057, LastOperation = Gather data, scope: EVERYTHING, LastPhase = Downlevel",
    "DeviceDriverInfo":null,
    "Remediation":[
        
    ],
    "SetupPhaseInfo":null,
    "SetupOperationInfo":null
}

Exemple de clé de Registre

Articles connexes

• Résoudre les erreurs de mise à niveau de Windows : informations techniques pour les professionnels de l’informatique.