SetupDiag
Si applica a
- Windows 10
Nota
Questo è un argomento di livello 300 (moderato avanzato).
Per un elenco completo degli argomenti di questo articolo, vedi Risolvere gli errori di aggiornamento di Windows 10 .
Informazioni su SetupDiag
Versione scaricabile corrente di SetupDiag: 1.6.2107.27002.
Assicurarsi sempre di eseguire la versione più recente di SetupDiag, in modo che possa accedere a nuove funzionalità e correggere i problemi noti.
SetupDiag è uno strumento di diagnostica che può essere usato per ottenere informazioni dettagliate sul motivo per cui un aggiornamento Windows 10 non è riuscito.
SetupDiag funziona esaminando i file di log del programma di installazione di Windows. Tenta di analizzare questi file di log per determinare la causa radice di un errore di aggiornamento o aggiornamento del computer a Windows 10. SetupDiag può essere eseguito nel computer che non è stato aggiornato oppure è possibile esportare i log dal computer in un altro percorso ed eseguire SetupDiag in modalità offline.
SetupDiag in Windows 10 versione 2004 e successive
Con il rilascio di Windows 10 versione 2004, SetupDiag è incluso nel programma di installazione di Windows.
Durante il processo di aggiornamento, il programma di installazione di Windows estrae tutti i file di origine nella directory %SystemDrive%$Windows.~bt\Sources . Con Windows 10 versione 2004 e successive, setupdiag.exe viene installato anche in questa directory. Se si verifica un problema con l'aggiornamento, SetupDiag verrà eseguito automaticamente per determinare la causa dell'errore.
Quando viene eseguito dal programma di installazione di Windows, vengono usati i parametri seguenti:
- /ZipLogs:False
- /Format:xml
- /Output:%windir%\logs\SetupDiag\SetupDiagResults.xml
- /RegPath:HKEY_LOCAL_MACHINE\SYSTEM\Setup\SetupDiag\Results
L'analisi setupDiag risultante è disponibile in %WinDir%\Logs\SetupDiag\SetupDiagResults.xml e nel Registro di sistema in HKLM\SYSTEM\Setup\SetupDiag\Results. Si noti che il percorso del Registro di sistema non è lo stesso del percorso predefinito del Registro di sistema quando SetupDiag viene eseguito manualmente. Quando SetupDiag viene eseguito manualmente e non viene specificato il parametro /RegPath, i dati vengono archiviati nel Registro di sistema in HKLM\SYSTEM\Setup\MoSetup\Volatile\SetupDiag.
Importante
Quando SetupDiag indica che si sono verificati più errori, l'ultimo errore nel file di log è in genere l'errore irreversibile, non il primo.
Se il processo di aggiornamento procede normalmente, la directory Sources che include setupdiag.exe viene spostata in %SystemDrive%\Windows.Old per la pulizia. Se la directory Windows.old viene eliminata in un secondo momento, verrà rimosso anche setupdiag.exe .
Uso di SetupDiag
Per usare rapidamente SetupDiag nel computer corrente:
- Verificare che il sistema soddisfi i requisiti descritti di seguito. Se necessario, installare .NET Framework 4.6.
- Scaricare SetupDiag.
- Se il Web browser chiede cosa fare con il file, scegliere Salva. Per impostazione predefinita, il file verrà salvato nella cartella Download . Se lo si desidera, è anche possibile salvarlo in un percorso diverso usando Salva con nome.
- Al termine del download di SetupDiag, aprire la cartella in cui è stato scaricato il file. Per impostazione predefinita, questa cartella è la cartella Download, visualizzata in Esplora file in Accesso rapido nel riquadro di spostamento a sinistra.
- Fare doppio clic sul file SetupDiag per eseguirlo. Selezionare Sì se viene richiesto di approvare l'esecuzione del programma.
- Facendo doppio clic sul file per eseguirlo, la finestra di comando verrà chiusa automaticamente al termine dell'analisi di SetupDiag. Se invece si desidera mantenere aperta questa finestra ed esaminare i messaggi visualizzati, eseguire il programma digitando SetupDiag al prompt dei comandi anziché fare doppio clic su di essa. Sarà necessario modificare le directory nel percorso di SetupDiag per eseguirla in questo modo.
- Verrà aperta una finestra di comando mentre SetupDiag diagnostica il computer. Attendere il completamento del processo.
- Al termine di SetupDiag, verranno creati due file nella stessa cartella in cui è stato fatto doppio clic su SetupDiag. Uno è un file di configurazione, l'altro è un file di log.
- Usare il Blocco note per aprire il file di log : SetupDiagResults.log.
- Esaminare le informazioni visualizzate. Se è stata trovata una corrispondenza con una regola, queste informazioni possono indicare il motivo per cui il computer non è riuscito a eseguire l'aggiornamento e potenzialmente come risolvere il problema. Vedere l'esempio di log di testo riportato di seguito.
Per istruzioni su come eseguire lo strumento in modalità offline e con opzioni più avanzate, vedere le sezioni Parametri ed esempi riportate di seguito.
La sezione Note sulla versione nella parte inferiore di questo articolo contiene informazioni sugli aggiornamenti recenti di questo strumento.
Requisiti
Il sistema operativo di destinazione deve essere Windows 10.
È necessario installare .NET Framework 4.6. Se non si è certi della versione di .NET attualmente installata, vedere Procedura: Determinare quali versioni di .NET Framework sono installate. È anche possibile usare la query della riga di comando seguente per visualizzare le versioni v4 installate:
reg query "HKLM\SOFTWARE\Microsoft\Net Framework Setup\NDP\v4" /s
Parameters
| Parametro | Descrizione |
|---|---|
| /? |
|
| /Output:<percorso del file dei risultati> |
|
| /LogsPath:<Percorso dei log> |
|
| /ZipLogs:<True | False> |
|
| /Format:<xml | json> |
|
| /Scenario:[Ripristino] |
|
| /Dettagliato |
|
| /NoTel |
|
| /AddReg |
|
| /RegPath |
|
Nota: il parametro /Mode è deprecato nella versione 1.4.0.0 di SetupDiag.
- Nelle versioni precedenti questo comando è stato usato con il parametro LogsPath per specificare che SetupDiag deve essere eseguito offline per analizzare un set di file di log acquisiti da un computer diverso. Nella versione 1.4.0.0, quando si specifica /LogsPath, SetupDiag verrà eseguito automaticamente in modalità offline, pertanto il parametro /Mode non è necessario.
Esempi:
Nell'esempio seguente, SetupDiag viene eseguito con parametri predefiniti (modalità online, il file dei risultati è SetupDiagResults.log nella stessa cartella in cui viene eseguito SetupDiag).
SetupDiag.exe
Nell'esempio seguente SetupDiag viene eseguito in modalità online (questa modalità è l'impostazione predefinita). Saprà dove cercare i log nel sistema corrente (non riuscito), quindi non è necessario raccogliere i log in anticipo. Viene specificata una posizione personalizzata per i risultati.
SetupDiag.exe /Output:C:\SetupDiag\Results.log
Nell'esempio seguente viene usato il parametro /Output per salvare i risultati in un nome di percorso che contiene uno spazio:
SetupDiag /Output:"C:\Tools\SetupDiag\SetupDiag Results\Results.log"
L'esempio seguente specifica che SetupDiag deve essere eseguito in modalità offline ed elaborare i file di log presenti in D:\Temp\Logs\LogSet1.
SetupDiag.exe /Output:C:\SetupDiag\Results.log /LogsPath:D:\Temp\Logs\LogSet1
Nell'esempio seguente viene impostato lo scenario di ripristino in modalità offline. Nell'esempio SetupDiag cercherà i log di reimpostazione/ripristino nel percorso LogsPath specificato e restituirà i risultati nella directory specificata dal parametro /Output.
SetupDiag.exe /Output:C:\SetupDiag\RecoveryResults.log /LogsPath:D:\Temp\Cabs\PBR_Log /Scenario:Recovery
Nell'esempio seguente viene impostato lo scenario di ripristino in modalità online. Nell'esempio SetupDiag cercherà i log di reimpostazione/ripristino nel sistema corrente e i risultati dell'output in formato XML.
SetupDiag.exe /Scenario:Recovery /Format:xml
File di log
I file di log di installazione di Windows e i log eventi contengono informazioni sulla posizione in cui vengono creati i log durante l'installazione di Windows. Per l'elaborazione offline, è consigliabile eseguire SetupDiag sul contenuto dell'intera cartella. Ad esempio, a seconda di quando l'aggiornamento non è riuscito, copiare una delle cartelle seguenti nella posizione offline:
\$Windows.~bt\sources\panther
\$Windows.~bt\Sources\Rollback
\Windows\Panther
\Windows\Panther\NewOS
Se si copia la cartella padre e tutte le sottocartelle, SetupDiag cercherà automaticamente i file di log in tutte le sottodirectory.
Configurare l'analisi del controllo dei bug
Quando Microsoft Windows rileva una condizione che compromette il funzionamento sicuro del sistema, il sistema si arresta. Questa condizione è denominata controllo bug. Viene anche comunemente definito un arresto anomalo del sistema, un errore del kernel, un errore di arresto o BSOD. In genere, questo errore è causato da un dispositivo hardware, un driver hardware o un software correlato.
Se i dump di arresto anomalo sono abilitati nel sistema, viene creato un file di dump di arresto anomalo. Se si verifica il controllo dei bug durante un aggiornamento, il programma di installazione di Windows estrarrà un file minidump (setupmem.dmp). SetupDiag può anche eseguire il debug di questi minidump correlati all'installazione.
Per eseguire il debug di un controllo dei bug correlato all'installazione, è necessario:
- Specificare il parametro /LogsPath . Non è possibile eseguire il debug dei dump di memoria in modalità online.
- Raccogliere il file di dump della memoria di installazione (setupmem.dmp) dal sistema che ha esito negativo.
- Setupmem.dmp verrà creato in %SystemDrive%$Windows.~bt\Sources\Rollback oppure in %WinDir%\Panther\NewOS\Rollback a seconda del momento in cui si verifica il controllo dei bug.
- Installare gli strumenti di debug di Windows nel computer che esegue SetupDiag.
Nell'esempio seguente il file setupmem.dmp viene copiato nella directory D:\Dump e gli strumenti di debug di Windows vengono installati prima di eseguire SetupDiag:
SetupDiag.exe /Output:C:\SetupDiag\Dumpdebug.log /LogsPath:D:\Dump
Problemi noti
- L'elaborazione di alcune regole può richiedere molto tempo se i file di log coinvolti sono di grandi dimensioni.
Output di esempio
Il comando seguente è un esempio in cui SetupDiag viene eseguito in modalità offline.
D:\SetupDiag>SetupDiag.exe /output:c:\setupdiag\result.xml /logspath:D:\Tests\Logs\f55be736-beed-4b9b-aedf-c133536c946e /format:xml
SetupDiag v1.6.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/2019 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/2019 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
Regole
Durante la ricerca dei file di log, SetupDiag usa un set di regole per identificare problemi noti. Queste regole sono contenute nel file rules.xml estratto durante l'esecuzione di SetupDiag. Il file rules.xml potrebbe essere aggiornato man mano che vengono rese disponibili nuove versioni di SetupDiag. Per altre informazioni, vedere la sezione note sulla versione .
Ogni nome di regola e il relativo identificatore di regola univoco associato sono elencati con una descrizione del problema noto di blocco dell'aggiornamento. Nelle descrizioni delle regole, il termine "livello inferiore" si riferisce alla prima fase del processo di aggiornamento, che viene eseguita nel sistema operativo iniziale.
- CompatScanOnly - FFDAFD37-DB75-498A-A893-472D49A1311D
- Questa regola indica che
setup.exeè stato chiamato con un parametro della riga di comando specifico che indicava che il programma di installazione doveva eseguire solo un'analisi di compatibilità, non un aggiornamento.
- Questa regola indica che
- BitLockerHardblock - C30152E2-938E-44B8-915B-D1181BA635AE
- Si tratta di un blocco di aggiornamento quando il sistema operativo di destinazione non supporta BitLocker, ma il sistema operativo host ha BitLocker abilitato.
- VHDHardblock - D9ED1B82-4ED8-4DFD-8EC0-BE69048978CC
- Questo blocco si verifica quando il sistema operativo host viene avviato in un'immagine del disco rigido virtuale. L'aggiornamento non è supportato quando il sistema operativo host viene avviato da un'immagine del disco rigido virtuale.
- PortableWorkspaceHardblock - 5B0D3AB4-212A-4CE4-BDB9-37CA404BB280
- Ciò indica che il sistema operativo host viene avviato da un dispositivo Windows To-Go (chiave USB). L'aggiornamento non è supportato nell'ambiente Windows To-Go.
- AuditModeHardblock - A03BD71B-487B-4ACA-83A0-735B0F3F1A90
- Questo blocco indica che il sistema operativo host è attualmente avviato in modalità di controllo, una modalità speciale per modificare lo stato di Windows. L'aggiornamento non è supportato da questo stato.
- SafeModeHardblock - 404D9523-B7A8-4203-90AF-5FBB05B6579B
- Questo blocco indica che il sistema operativo host viene avviato in modalità provvisoria, in cui l'aggiornamento non è supportato.
- InsufficientSystemPartitionDiskSpaceHardblock - 3789FBF8-E177-437D-B1E3-D38B4C4269D1
- Questo blocco viene rilevato quando l'installazione determina che la partizione di sistema (in cui sono archiviati i file del caricatore di avvio) non ha spazio sufficiente per essere gestita con i file di avvio più recenti necessari durante il processo di aggiornamento.
- CompatBlockedApplicationAutoUninstall - BEBA5BC6-6150-413E-8ACE-5E1EC8D34DD5
- Questa regola indica che è necessario disinstallare un'applicazione prima che l'installazione possa continuare.
- CompatBlockedApplicationDismissable - EA52620B-E6A0-4BBC-882E-0686605736D9
- Quando si esegue l'installazione in modalità /quiet, sono presenti messaggi dell'applicazione ignorabili che si trasformano in blocchi a meno che la riga di comando non specifichi anche "/compat ignorewarning". Questa regola indica che l'installazione è stata eseguita in modalità /quiet, ma è presente un messaggio di blocco ignorabile dell'applicazione che ha impedito la continuazione dell'installazione.
- CompatBlockedApplicationManualUninstall - 9E912E5F-25A5-4FC0-BEC1-CA0EA5432FF4
- Questa regola indica che un'applicazione senza una voce Installazione applicazioni è presente nel sistema e blocca la continuazione dell'installazione. Ciò richiede in genere la rimozione manuale dei file associati a questa applicazione per continuare.
- HardblockDeviceOrDriver - ED3AEFA1-F3E2-4F33-8A21-184ADF215B1B
- Questo errore indica che un driver di dispositivo caricato nel sistema operativo host non è compatibile con la versione più recente del sistema operativo e deve essere rimosso prima dell'aggiornamento.
- HardblockMismatchedLanguage - 60BA8449-CF23-4D92-A108-D6FCEFB95B45
- Questa regola indica che il sistema operativo host e le edizioni del linguaggio del sistema operativo di destinazione non corrispondono.
- HardblockFlightSigning - 598F2802-3E7F-4697-BD18-7A6371C8B2F8
- Questa regola indica che il sistema operativo di destinazione è una versione non definitiva, la compilazione di Windows Insider e il computer di destinazione ha l'avvio protetto abilitato. In questo modo la build firmata non definitiva non verrà avviata se installata nel computer.
- DiskSpaceBlockInDownLevel - 6080AFAC-892E-4903-94EA-7A17E69E549E
- Questo errore indica che lo spazio su disco è esaurito durante le operazioni di livello inferiore dell'aggiornamento.
- DiskSpaceFailure - 981DCBA5-B8D0-4BA7-A8AB-4030F7A10191
- Questo errore indica che l'unità di sistema ha esaurito lo spazio disponibile su disco a un certo punto dopo il primo riavvio nell'aggiornamento.
- DeviceInstallHang - 37BB1C3A-4D79-40E8-A556-FDA126D40BC6
- Questa regola di errore indica che il sistema è bloccato o il bug è stato controllato durante la fase di installazione del dispositivo dell'aggiornamento.
- DebugSetupMemoryDump - C7C63D8A-C5F6-4255-8031-74597773C3C6
- Questa regola solo offline indica che si è verificato un controllo bug durante l'installazione. Se gli strumenti del debugger sono disponibili nel sistema, SetupDiag eseguirà il debug del dump della memoria e fornirà i dettagli.
- DebugSetupCrash - CEEBA202-6F04-4BC3-84B8-7B99AED924B1
- Questa regola solo offline indica che l'installazione stessa ha riscontrato un errore che ha causato un dump della memoria del processo. Se gli strumenti del debugger sono installati nel sistema, SetupDiag eseguirà il debug del dump della memoria e fornirà ulteriori dettagli.
- DebugMemoryDump - 505ED489-329A-43F5-B467-FCAAF6A1264C
- Questa regola offline è valida solo per qualsiasi file memory.dmp risultante durante l'operazione di installazione/aggiornamento. Se gli strumenti del debugger sono installati nel sistema, SetupDiag eseguirà il debug del dump della memoria e fornirà ulteriori dettagli.
- BootFailureDetected - 4FB446C2-D4EC-40B4-97E2-67EB19D1CFB7
- Questa regola indica che si è verificato un errore di avvio durante una fase specifica dell'aggiornamento. La regola indicherà il codice di errore e la fase per scopi diagnostici.
- FindDebugInfoFromRollbackLog - 9600EB68-1120-4A87-9FE9-3A4A70ACFC37
- Questa regola determinerà e fornirà i dettagli quando si verifica un controllo dei bug durante il processo di installazione/aggiornamento che ha generato un dump di memoria, ma senza che il pacchetto del debugger sia presente nel computer in esecuzione.
- AdvancedInstallerFailed - 77D36C96-32BE-42A2-BB9C-AAFFE64FCADC
- Trova operazioni di installazione avanzate irreversibili che causano errori di installazione.
- FindMigApplyUnitFailure - A4232E11-4043-4A37-9BF4-5901C46FD781
- Rileva un errore dell'unità di migrazione che ha causato l'errore dell'aggiornamento. Questa regola restituisce il nome del plug-in di migrazione e il codice di errore generato a scopo diagnostico.
- FindMigGatherUnitFailure - D04C064B-CD77-4E64-96D6-D26F30B4EE29
- Rileva un errore dell'unità di raccolta della migrazione che ha causato l'errore dell'aggiornamento. Questa regola restituisce il nome dell'unità di raccolta/plug-in e il codice di errore generato a scopo diagnostico.
- CriticalSafeOSDUFailure - 73566DF2-CA26-4073-B34C-C9BC70DBF043
- Questa regola indica un errore durante l'aggiornamento dell'immagine SafeOS con un aggiornamento dinamico critico. Indicherà la fase e il codice di errore che si sono verificati durante il tentativo di aggiornare l'immagine SafeOS a scopo diagnostico.
- UserProfileCreationFailureDuringOnlineApply - 678117CE-F6A9-40C5-BC9F-A22575C78B14
- Indica che si è verificato un errore critico durante la creazione o la modifica di un profilo utente durante la fase di applicazione online dell'aggiornamento. Indicherà l'operazione e il codice di errore associati all'errore a scopo diagnostico.
- WimMountFailure - BE6DF2F1-19A6-48C6-AEF8-D3B0CE3D4549
- Questa regola indica che l'aggiornamento non è riuscito a montare un file WIM. Verrà visualizzato il nome del file WIM e il messaggio di errore e il codice di errore associati all'errore a scopo diagnostico.
- FindSuccessfulUpgrade - 8A0824C8-A56D-4C55-95A0-22751AB62F3E
- Determina se l'installazione specificata ha avuto esito positivo o non è stata basata sui log.
- FindSetupHostReportedFailure - 6253C04F-2E4E-4F7A-B88E-95A69702F7EC
- Fornisce informazioni sugli errori che si sono verificati nelle prime fasi del processo di aggiornamento setuphost.exe
- FindDownlevelFailure - 716334B7-F46A-4BAA-94F2-3E31BC9EFA55
- Fornisce informazioni sugli errori visualizzate da SetupPlatform, più avanti nella fase di livello inferiore.
- FindAbruptDownlevelFailure - 55882B1A-DA3E-408A-9076-23B22A0472BD
- Fornisce informazioni sull'ultimo errore dell'operazione quando il sistema ha esito negativo nel livello inferiore, ma il log termina improvvisamente.
- FindSetupPlatformFailedOperationInfo - 307A0133-F06B-4B75-AEA8-116C3B53C2D1
- Fornisce informazioni sull'ultima fase e sull'errore quando SetupPlatform indica un errore critico. Questa regola indicherà l'operazione e l'errore associati all'errore a scopo diagnostico.
- FindRollbackFailure - 3A43C9B5-05B3-4F7C-A955-88F991BB5A48
- Fornisce l'ultima operazione, la fase di errore e le informazioni sull'errore quando si verifica un rollback.
- AdvancedInstallerGenericFailure - 4019550D-4CAA-45B0-A222-349C48E86F71
- Regola che corrisponde agli errori di lettura/scrittura di AdvancedInstaller in senso generico. Restituisce l'eseguibile chiamato, nonché il codice di errore e il codice di uscita segnalati.
- OptionalComponentFailedToGetOCsFromPackage - D012E2A2-99D8-4A8C-BBB2-088B92083D78 (NOTA: questa regola sostituisce la regola OptionalComponentInstallFailure presente nella versione 1.10.
- Corrisponde a uno specifico errore del componente facoltativo quando si tenta di enumerare i componenti in un pacchetto. Restituisce il nome del pacchetto e il codice di errore.
- OptionalComponentOpenPackageFailed - 22952520-EC89-4FBD-94E0-B67DF88347F6
- Corrisponde a un errore specifico del componente facoltativo quando si tenta di aprire un pacchetto OC. Restituisce il nome del pacchetto e il codice di errore.
- OptionalComponentInitCBSSessionFailed - 63340812-9252-45F3-A0F2-B2A4CA5E9317
- Corrisponde a un errore specifico in cui il servizio o i componenti del programma di installazione avanzato non sono operativi o avviati nel sistema. Restituisce il codice di errore.
- UserProfileCreationFailureDuringFinalize - C6677BA6-2E53-4A88-B528-336D15ED1A64
- Corrisponde a un errore di creazione del profilo utente specifico durante la fase di finalizzazione dell'installazione. Restituisce il codice di errore.
- WimApplyExtractFailure - 746879E9-C9C5-488C-8D4B-0C811FF3A9A8
- Corrisponde a un errore di applicazione WIM durante le fasi di estrazione WIM della configurazione. Restituisce l'estensione, il percorso e il codice di errore.
- UpdateAgentExpanderFailure - 66E496B3-7D19-47FA-B19B-4040B9FD17E2
- Corrisponde agli errori dell'espansore DPX nella fase di aggiornamento di livello inferiore da Windows Update. Restituisce il nome del pacchetto, la funzione, l'espressione e il codice di errore.
- FindFatalPluginFailure - E48E3F1C-26F6-4AFB-859B-BF637DA49636
- Corrisponde a qualsiasi errore del plug-in che setupplatform decide che l'installazione è irreversibile. Restituisce il nome, l'operazione e il codice di errore del plug-in.
- AdvancedInstallerFailed - 77D36C96-32BE-42A2-BB9C-AAFFE64FCADC
- Indica un errore critico in AdvancedInstaller durante l'esecuzione di un pacchetto del programma di installazione, include il .exe chiamato, la fase, la modalità, il componente e i codici di errore.
- MigrationAbortedDueToPluginFailure - D07A24F6-5B25-474E-B516-A730085940C9
- Indica un errore critico in un plug-in di migrazione che causa l'interruzione della migrazione da parte dell'installazione. Fornirà l'operazione di installazione, il nome del plug-in, l'azione del plug-in e il codice di errore.
- DISMAddPackageFailed - 6196FF5B-E69E-4117-9EC6-9C1EAB20A3B9
- Indica un errore critico durante un'operazione di aggiunta del pacchetto di Gestione e manutenzione immagini distribuzione. Specifica il nome del pacchetto, l'errore di Gestione e manutenzione immagini distribuzione e aggiunge il codice di errore del pacchetto.
- PlugInComplianceBlock - D912150B-1302-4860-91B5-527907D08960
- Rileva tutti i blocchi di compatibilità dai plug-in di conformità del server. Restituisce le informazioni sul blocco e la correzione.
- AdvancedInstallerGenericFailure - 4019550D-4CAA-45B0-A222-349C48E86F71
- Attiva gli errori avanzati del programma di installazione in senso generico, generando l'applicazione denominata, fase, modalità, componente e codice di errore.
- FindMigGatherApplyFailure - A9964E6C-A2A8-45FF-B6B5-25E0BD71428E
- Visualizza gli errori quando il motore di migrazione ha esito negativo in un'operazione di raccolta o applicazione. Indica l'oggetto Migrazione (percorso file o Registro di sistema), la migrazione
- OptionalComponentFailedToGetOCsFromPackage - D012E2A2-99D8-4A8C-BBB2-088B92083D78
- Indica che l'operazione di migrazione del componente facoltativo (OC) non è riuscita a enumerare i componenti facoltativi da un pacchetto OC. Restituisce il nome del pacchetto e il codice di errore.
- OptionalComponentOpenPackageFailed - 22952520-EC89-4FBD-94E0-B67DF88347F6
- Indica che l'operazione di migrazione del componente facoltativo non è riuscita ad aprire un pacchetto del componente facoltativo. Restituisce il nome del pacchetto e il codice di errore.
- OptionalComponentInitCBSSessionFailed - 63340812-9252-45F3-A0F2-B2A4CA5E9317
- Indica il danneggiamento nello stack di manutenzione nel sistema di livello inferiore. Restituisce il codice di errore rilevato durante il tentativo di inizializzare il componente di manutenzione nel sistema operativo esistente.
- DISMproviderFailure - D76EF86F-B3F8-433F-9EBF-B4411F8141F4
- Si attiva quando un provider di Gestione e manutenzione immagini distribuzione (plug-in) non riesce in un'operazione critica. Restituisce il file (nome del plug-in), la funzione denominata + codice di errore e il messaggio di errore dal provider.
- SysPrepLaunchModuleFailure - 7905655C-F295-45F7-8873-81D6F9149BFD
- Indica che un plug-in sysPrep non è riuscito in un'operazione critica. Indica il nome del plug-in, il nome dell'operazione e il codice di errore.
- UserProvidedDriverInjectionFailure - 2247C48A-7EE3-4037-AFAB-95B92DE1D980
- Un driver fornito per l'installazione (tramite input della riga di comando) non è riuscito in qualche modo. Restituisce la funzione di installazione del driver e il codice di errore.
- PlugInComplianceBlock - D912150B-1302-4860-91B5-527907D08960
- Questi sono solo per gli aggiornamenti del server, restituirà il blocco di conformità e la correzione necessari.
- PreReleaseWimMountDriverFound - 31EC76CC-27EC-4ADC-9869-66ABEDB56F0
- Acquisisce gli errori dovuti alla registrazione di un driver di wimmount.sys non riconosciuto nel sistema.
- WinSetupBootFilterFailure - C073BFC8-5810-4E19-B53B-4280B79E096C
- Rileva gli errori nelle operazioni sui file in modalità kernel.
- WimMountDriverIssue - 565B60DD-5403-4797-AE3E-BC5CB972FBAE
- Rileva gli errori nella registrazione WimMount.sys nel sistema.
- DISMImageSessionFailure - 61B7886B-10CD-4C98-A299-B987CB24A11C
- Acquisisce le informazioni sugli errori quando Gestione e manutenzione immagini distribuzione non riesce ad avviare correttamente una sessione di immagini.
- FindEarlyDownlevelError - A4CE4FC9-5E10-4BB1-8ECE-3B29EB9D7C52
- Rileva gli errori nella fase di livello inferiore prima che venga richiamata la piattaforma di configurazione.
- FindSPFatalError - A4028172-1B09-48F8-AD3B-86CDD7D55852
- Acquisisce le informazioni sugli errori quando la piattaforma di installazione rileva un errore irreversibile.
- UserProfileSuffixMismatch - B4BBCCCE-F99D-43EB-9090-078213397FD8
- Rileva quando un file o un altro oggetto causa l'esito negativo della migrazione o della creazione di un profilo utente durante l'aggiornamento.
Note sulla versione
27/07/2021 - SetupDiag v1.6.2107.27002 viene rilasciato con 61 regole, come strumento autonomo disponibile nell'Area download.
- Questa versione contiene aggiornamenti della conformità e correzioni di bug secondarie.
- Con questa versione e le versioni successive, il numero di versione dello strumento SetupDiag scaricabile è diverso da quello incluso nel programma di installazione di Windows.
06/05/2021 - SetupDiag v1.6.1.0 viene rilasciato con 61 regole, come strumento autonomo disponibile nell'Area download.
- Questa versione di SetupDiag è inclusa in Windows 10 versione 21H1.
- Viene aggiunta una nuova regola: UserProfileSuffixMismatch.
- Tutti gli output della riga di comando sono ora impostazioni cultura invarianti ai fini del formato data/ora
- È stato risolto un problema con l'output del Registro di sistema in cui il risultato "nessuna corrispondenza trovata" causava un valore di REG_SZ danneggiato.
08/08/2019 - SetupDiag v1.6.0.42 viene rilasciato con 60 regole, come strumento autonomo disponibile nell'Area download.
- Le prestazioni di rilevamento dei log sono migliorate. Il rilevamento dei log richiede circa 10 secondi o meno prima che possa richiedere fino a un minuto.
- Sono state aggiunte informazioni sull'operazione di installazione e sulla fase di installazione sia nel log dei risultati che nelle informazioni del Registro di sistema.
- Si tratta dell'ultima operazione e fase in cui si è verificato l'installazione quando si è verificato l'errore.
- Aggiunta di informazioni dettagliate sull'operazione di installazione e sulla fase di installazione (e temporizzazione) al log di output quando viene specificato /verbose.
- Nota: se il problema riscontrato è un blocco di compatibilità, non esistono ancora informazioni sull'operazione di installazione o sulla fase e pertanto non saranno disponibili.
- Sono state aggiunte altre informazioni all'output del Registro di sistema.
- Informazioni dettagliate su 'FailureData' dove disponibile. Esempio: "AppName = MyBlockedApplication" o "DiskSpace = 6603" (in MB)
- Dati "Key = Value" specifici dell'errore rilevato.
- Aggiunti 'UpgradeStartTime', 'UpgradeEndTime' e 'UpgradeElapsedTime'
- Aggiunta di "SetupDiagVersion", "DateTime" (per indicare quando è stato eseguito SetupDiag nel sistema), "TargetOSVersion", "HostOSVersion" e altro ancora...
- Informazioni dettagliate su 'FailureData' dove disponibile. Esempio: "AppName = MyBlockedApplication" o "DiskSpace = 6603" (in MB)
19/06/2019 - SetupDiag v1.5.0.0 viene rilasciato con 60 regole, come strumento autonomo disponibile nell'Area download.
- Tutti gli output di data e ora vengono aggiornati al formato localizzato per ogni richiesta utente.
- Aggiunta di informazioni sull'operazione di installazione e sulla fase al log /verbose.
- Aggiunta dell'ultima operazione di installazione e dell'ultima fase di installazione alla maggior parte delle regole in cui ha senso (vedere il nuovo output di seguito).
- Miglioramento delle prestazioni nella ricerca di setupact.logs per determinare il log corretto da analizzare.
- Aggiunta del numero di versione di SetupDiag al report di testo (xml e json lo avevano sempre).
- Aggiunta di report "nessuna corrispondenza" per xml e json per ogni richiesta utente.
- Output Json formattato per una facile leggibilità.
- Miglioramenti delle prestazioni durante la ricerca dei log di installazione; questo dovrebbe essere molto più veloce ora.
- Sono state aggiunte sette nuove regole: PlugInComplianceBlock, PreReleaseWimMountDriverFound, WinSetupBootFilterFailure, WimMountDriverIssue, DISMImageSessionFailure, FindEarlyDownlevelError e FindSPFatalError. Per altre informazioni, vedere la sezione Regole precedente.
- Le informazioni di diagnostica vengono ora restituite al Registro di sistema in HKLM\SYSTEM\Setup\MoSetup\Volatile\SetupDiag
- Il comando /AddReg è stato aggiunto per attivare/disattivare l'output del Registro di sistema. Questa impostazione è disattivata per impostazione predefinita per la modalità offline e per impostazione predefinita per la modalità online. Il comando non ha alcun effetto per la modalità online e abilita l'output del Registro di sistema per la modalità offline.
- Questa chiave del Registro di sistema viene eliminata non appena SetupDiag viene eseguita una seconda volta e sostituita con i dati correnti, quindi è sempre aggiornata.
- Questa chiave del Registro di sistema viene eliminata anche quando viene richiamata una nuova istanza di aggiornamento.
- Per un esempio, vedere Chiave del Registro di sistema di esempio.
17/05/2019 - SetupDiag v1.4.1.0 viene rilasciato con 53 regole, come strumento autonomo disponibile nell'Area download.
- Questa versione consente di trovare e diagnosticare gli errori di ripristino e ripristino (reimpostazione rapida).
18/12/2018 - SetupDiag v1.4.0.0 viene rilasciato con 53 regole, come strumento autonomo disponibile nell'Area download.
- Questa versione include miglioramenti importanti nelle prestazioni di elaborazione delle regole: prestazioni di elaborazione delle regole circa 3 volte più veloci.
- La regola FindDownlevelFailure è fino a 10 volte più veloce.
- Sono state aggiunte nuove regole per analizzare gli errori di aggiornamento a Windows 10 versione 1809.
- È disponibile un nuovo collegamento alla Guida per la risoluzione degli errori dello stack di manutenzione nel sistema operativo di livello inferiore quando la corrispondenza della regola indica questo tipo di errore.
- Rimozione della necessità di specificare il parametro /Mode. Ora, se si specifica /LogsPath, si presuppone automaticamente la modalità offline.
- Sono stati apportati alcuni miglioramenti funzionali e di output per diverse regole.
16/07/2018 - SetupDiag v1.3.1 viene rilasciato con 44 regole, come strumento autonomo disponibile nell'Area download.
- Questa versione risolve un problema che può verificarsi durante l'esecuzione di SetupDiag in modalità online in un computer che produce un file setupmem.dmp, ma che non dispone di file binari del debugger installati.
10/07/2018 - SetupDiag v1.30 viene rilasciato con 44 regole, come strumento autonomo disponibile nell'Area download.
- Correzione di bug per una regola del plug-in sovra-corrispondente. La regola ora corrisponderà correttamente solo ai problemi critici (errore di installazione) del plug-in.
- Nuova funzionalità: possibilità di restituire i log in formato JSON e XML.
- Usare i parametri della riga di comando "/Format:xml" o "/Format:json" per specificare il nuovo formato di output. Vedere i log di esempio nella parte inferiore di questo argomento.
- Se il parametro "/Format:xml" o "/Format:json" viene omesso, il formato di output del log verrà omesso per impostazione predefinita come testo.
- Nuova funzionalità: se possibile, nell'output della regola vengono ora fornite istruzioni specifiche per correggere l'errore identificato. Ad esempio, vengono fornite istruzioni per correggere i problemi di blocco noti, ad esempio la disinstallazione di un'app incompatibile o la liberazione di spazio nell'unità di sistema.
- Sono state aggiunte tre nuove regole: AdvancedInstallerFailed, MigrationAbortedDueToPluginFailure, DISMAddPackageFailed.
30/05/2018 - SetupDiag v1.20 viene rilasciato con 41 regole, come strumento autonomo disponibile nell'Area download.
- Correzione di un bug nel rilevamento degli errori di installazione del dispositivo in modalità online.
- È stato modificato SetupDiag in modo che funzioni senza un'istanza di setupact.log. In precedenza, SetupDiag richiedeva almeno un setupact.log per funzionare. Questa modifica consente allo strumento di analizzare gli errori di aggiornamento che si verificano prima di chiamare SetupHost.
- Viene eseguito il refactoring dei dati di telemetria per inviare solo il nome e il GUID della regola (o "NoRuleMatched" se non viene trovata una corrispondenza con alcuna regola) e l'ID report setup360. Questa modifica garantisce la privacy dei dati durante l'elaborazione delle regole.
02/05/2018 - SetupDiag v1.10 viene rilasciato con 34 regole, come strumento autonomo disponibile nell'Area download.
- È stato aggiunto un miglioramento delle prestazioni per velocizzare l'elaborazione delle regole.
- L'output delle regole include ora collegamenti agli articoli di supporto, se applicabile.
- SetupDiag fornisce ora il percorso e il nome dei file che sta elaborando.
- È ora possibile eseguire SetupDiag selezionandolo e quindi esaminando il file di log di output.
- Ora viene sempre creato un file di log di output, indipendentemente dal fatto che sia stata trovata una corrispondenza con una regola.
30/03/2018 - SetupDiag v1.00 viene rilasciato con 26 regole, come strumento autonomo disponibile nell'Area download.
Log di esempio
Esempio di log di testo
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/2018 9:47:16 PM
UpgradeEndTime = 3/21/2018 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://learn.microsoft.com/windows/deployment/upgrade/upgrade-error-codes for error information.
Esempio di log 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://learn.microsoft.com/windows/deployment/upgrade/setupdiag">
<Version>1.6.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>2019-06-06T21:19:10</UpgradeStartTime>
<UpgradeElapsedTime />
<UpgradeEndTime>2019-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>2019-06-06 21:47:11, Error SP Error converting install time 5/2/2019 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: 2019-06-06 21:47:11, Error SP Error converting install time 5/2/2019 to structure[gle=0x00000057]</FailureData>
<FailureData>LogEntry: 2019-06-06 21:47:11, Error SP Error converting install time 5/2/2019 to structure[gle=0x00000057]</FailureData>
<FailureData>
Refer to "https://learn.microsoft.com/windows/desktop/Debug/system-error-codes" for error information.</FailureData>
<FailureDetails>Err = 0x00000057, LastOperation = Gather data, scope: EVERYTHING, LastPhase = Downlevel</FailureDetails>
</SetupDiag>
Esempio di log 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":"2019-06-06 21:47:11, Error SP Error converting install time 5\/2\/2019 to structure[
gle=0x00000057
]",
"FailureData":[
"\u000aError: SetupDiag reports Fatal Error.\u000aLast Setup Phase = Downlevel\u000aLast Setup Operation: Gather data, scope: EVERYTHING\u000aError: 0x00000057",
"LogEntry: 2019-06-06 21:47:11, Error SP Error converting install time 5\/2\/2019 to structure[
gle=0x00000057
]",
"LogEntry: 2019-06-06 21:47:11, Error SP Error converting install time 5\/2\/2019 to structure[
gle=0x00000057
]",
"\u000aRefer to \"https:\/\/learn.microsoft.com\/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
}
Chiave del Registro di sistema di esempio
Articoli correlati
Risolvere gli errori di aggiornamento Windows 10: informazioni tecniche per i professionisti IT