SetupDiag

Artigo
02/14/2024
Aplica-se a:

✅ Windows 11, ✅ Windows 10

Observação

Este artigo é um artigo de nível 300 (avançado moderado). Consulte Resolver erros de atualização do Windows para obter uma lista completa de artigos nesta seção.

Baixar a versão mais recente do SetupDiag

Sobre SetupDiag

Importante

Quando SetupDiag é executado manualmente, a Microsoft recomenda executar a versão mais recente do SetupDiag. A versão mais recente está disponível por meio do link de download a seguir. A execução da versão mais recente garante a funcionalidade mais recente e corrige problemas conhecidos.

SetupDiag é uma ferramenta de diagnóstico que pode ser usada para obter detalhes sobre por que uma atualização do Windows não foi bem sucedida.

SetupDiag funciona examinando arquivos de log de instalação do Windows. Ele tenta analisar esses arquivos de log para determinar a causa raiz de uma falha na atualização ou atualização do computador para o Windows. SetupDiag pode ser executado no computador que não foi atualizado. Os logs também podem ser exportados do computador para outro local e, em seguida, executar o SetupDiag no modo offline.

SetupDiag está incluído com a Instalação do Windows em todas as versões com suporte atual do Windows.

Durante o processo de atualização, o Windows Setup extrai todos os seus arquivos de origem, incluindo SetupDiag.exe, para o diretório %SystemDrive%$Windows.~bt\Sources . Se houver um problema com a atualização, o SetupDiag será executado automaticamente para determinar a causa da falha.

Quando executados pela Configuração do Windows, os seguintes parâmetros são usados :

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

A análise de SetupDiag resultante pode ser encontrada no %WinDir%\Logs\SetupDiag\SetupDiagResults.xml e no registro HKLM\SYSTEM\Setup\SetupDiag\Resultsem .

Observação

Quando a Instalação do Windows executa o SetupDiag automaticamente, o caminho do registro não é o mesmo que o caminho padrão do registro quando SetupDiag é executado manualmente. Quando SetupDiag é executado manualmente e o /RegPath parâmetro não é especificado, os dados são armazenados no registro em HKLM\SYSTEM\Setup\MoSetup\Volatile\SetupDiag.

Importante

Quando SetupDiag indica que houve várias falhas, a última falha no arquivo de log normalmente é o erro fatal, não o primeiro.

Se o processo de atualização continuar normalmente, o diretório Fontes , incluindo SetupDiag.exe , será movido em %SystemDrive%\Windows.Old para limpeza. Se o diretório windows.old for excluído posteriormente, SetupDiag.exe também será removido.

Requisitos

A versão de destino do Windows deve ser uma versão com suporte no momento do Windows. A versão originalmente instalada do Windows pode ser uma versão do Windows que está sem suporte desde que:
- A versão de destino do Windows é uma versão atualmente com suporte do Windows.
- A atualização para a versão de destino do Windows tem suporte na versão original instalada do Windows.
.NET Framework 4.7.2 ou mais recente deve ser instalado. Para determinar qual versão do .NET está pré-instalada com uma versão específica do Windows, consulte .NET Framework requisitos do sistema: sistemas operacionais cliente com suporte. Para determinar qual versão do .NET está instalada no momento, consulte Como determinar quais .NET Framework versões estão instaladas.

A consulta de linha de comando a seguir pode ser usada para exibir a versão atualmente instalada do .NET:
```
reg.exe query "HKLM\SOFTWARE\Microsoft\Net Framework Setup\NDP\v4" /s
```
Desde que pelo menos a versão necessária do .NET seja instalada, nenhuma ação adicional será necessária, inclusive se uma versão mais recente estiver instalada.

Usando SetupDiag

Para usar rapidamente o SetupDiag no computador atual:

Verifique se o sistema atende aos requisitos.
Baixe SetupDiag.
Se o navegador da Web perguntar o que fazer com o arquivo, escolha Salvar. Por padrão, o arquivo é salvo na pasta Downloads . Se desejado, o arquivo também pode ser salvo em um local diferente usando o Save As.
Quando SetupDiag terminar de baixar, abra a pasta em que o arquivo foi baixado. Por padrão, essa pasta é a pasta Downloads, que é exibida em Explorador de Arquivos em Acesso rápido no painel de navegação esquerdo.
Clique duas vezes no arquivo SetupDiag para executá-lo. Selecione Sim se for solicitado a aprovar a execução do programa.

Clicar duas vezes no arquivo para executá-lo fecha automaticamente a janela de comando quando SetupDiag conclui sua análise. Para manter a janela aberta para examinar as mensagens geradas pelo SetupDiag, execute o programa digitando SetupDiag no prompt de comando em vez de clicar duas vezes nele. Ao executar a partir de um prompt de comando, certifique-se de alterar diretórios para onde o SetupDiag está localizado.

Uma janela de comando é aberta enquanto SetupDiag diagnostica o computador. Aguarde até que esse processo seja concluído.
Quando SetupDiag é concluído, dois arquivos são criados na mesma pasta da qual o SetupDiag foi executado. Um é um arquivo de configuração, o outro é um arquivo de log.
Use o Bloco de Notas para abrir o arquivo de log SetupDiagResults.log.
Examine as informações exibidas. Se uma regra foi correspondida, essas informações podem dizer por que o computador não foi atualizado e, potencialmente, como corrigir o problema. Confira a seção Exemplo de log de texto.

Para obter instruções sobre como executar a ferramenta no modo offline e com opções mais avançadas, consulte as seções Parâmetros e Exemplos.

Parâmetros

Parâmetro	Descrição
/?	Exibe ajuda interativa
/Output:[Caminho completo e nome do arquivo para o arquivo de log de saída]	Esse parâmetro opcional especifica o nome e o local do arquivo de log de resultados. O arquivo de saída contém a análise de SetupDiag. Há suporte apenas para a saída do formato de texto. O trabalho de caminhos UNC forneceu o contexto no qual o SetupDiag é executado tem acesso ao caminho UNC. Se o caminho tiver um espaço nele, todo o caminho deverá ser fechado em aspas duplas ("). Consulte as seções Exemplos para obter um exemplo. Padrão: se não for especificado, SetupDiag criará o SetupDiagResults.log de arquivo no mesmo diretório em queSetupDiag.exe é executado.
/LogsPath:[Caminho completo para logs]	Esse parâmetro opcional especifica o local dos logs a serem analisados e onde localizar os arquivos de log para uma análise offline. Esses arquivos de log podem estar em um formato de pasta simples ou contendo vários subdiretórios. SetupDiag pesquisa recursivamente todos os diretórios filho. O padrão é verificar o sistema atual em busca de logs.
/ZipLogs:[True \| False]	Esse parâmetro opcional informa SetupDiag.exe criar um arquivo zip contendo os resultados e todos os arquivos de log analisados. O arquivo zip é criado no mesmo diretório em queSetupDiag.exe é executado. Padrão: se não for especificado, um valor de 'true' será usado.
/Format:[xml \| json]	Este parâmetro opcional especifica o formato de saída para arquivos de log serem XML ou JSON. Se esse parâmetro não for especificado, o formato de texto será usado por padrão.
/Scenario:[Recovery \| Depuração]	Esse parâmetro opcional pode fazer um dos dois itens a seguir com base no argumento usado: A recuperação instrui SetupDiag.exe a procurar e processar logs de redefinição e recuperação e ignorar logs de instalação/atualização. A depuração instrui SetupDiag.exe a depurar despejos de memória se os binários de depuração necessários forem instalados.
/Verbose	Esse parâmetro opcional cria um log de diagnóstico no diretório atual, com informações de depuração, dados adicionais e detalhes sobre SetupDiag. Por padrão, SetupDiag só produz uma entrada de arquivo de log para erros principais. Usar /Verbose faz com que o SetupDiag sempre produza outro arquivo de log com detalhes de depuração. Esses detalhes podem ser úteis ao relatar um problema com SetupDiag.
/NoTel	Esse parâmetro opcional informa SetupDiag.exe não enviar telemetria de diagnóstico para a Microsoft.
/RegPath	Este parâmetro opcional instrui SetupDiag.exe a adicionar informações de falha ao registro no caminho determinado. Os caminhos do registro devem começar com HKEY_LOCAL_MACHINE ou HKEY_CURRENT_USER e estar acessíveis no nível de elevação em que SetupDiag é executado. Se esse parâmetro não for especificado, o caminho padrão será HKLM\SYSTEM\Setup\MoSetup\Volatile\SetupDiag.
/AddReg	Este parâmetro opcional instrui SetupDiag.exe a adicionar informações de falha ao registro no sistema de execução no modo offline. SetupDiag por padrão adiciona informações de falha ao registro apenas no modo Online. Os dados do registro vão para HKEY_LOCAL_MACHINE\SYSTEM\Setup\MoSetup\Volatile\SetupDiag , a menos que sejam especificados de outra forma.

Observação

O parâmetro /Mode é preterido em SetupDiag.

Em versões anteriores, esse comando foi usado com o parâmetro LogsPath para especificar que SetupDiag deve ser executado de maneira offline para analisar um conjunto de arquivos de log que foram capturados de um computador diferente. Nas versões atuais do SetupDiag, quando /LogsPath é especificado, o SetupDiag é executado automaticamente no modo offline, portanto, o parâmetro /Mode não é necessário.

Exemplos

No exemplo a seguir, SetupDiag é executado com parâmetros padrão no modo online. O arquivo de resultados é SetupDiagResults.log na mesma pasta em que o SetupDiag é executado.
```
SetupDiag.exe
```
No exemplo a seguir, SetupDiag é executado no modo online (esse modo é o padrão). Ele sabe onde procurar logs no sistema atual (com falha), portanto, não há necessidade de coletar logs com antecedência. Um local personalizado para resultados é especificado.
```
SetupDiag.exe /Output:C:\SetupDiag\Results.log
```
O exemplo a seguir usa o parâmetro /Output para salvar resultados em um nome de caminho que contém um espaço:
```
SetupDiag /Output:"C:\Tools\SetupDiag\SetupDiag Results\Results.log"
```
O exemplo a seguir especifica que SetupDiag deve ser executado no modo offline e processar os arquivos de log encontrados em D:\Temp\Logs\LogSet1.
```
SetupDiag.exe /Output:C:\SetupDiag\Results.log /LogsPath:D:\Temp\Logs\LogSet1
```
O exemplo a seguir define o cenário de recuperação no modo offline. No exemplo, SetupDiag pesquisa logs de redefinição/recuperação no local do LogsPath especificado e gera os resultados para o diretório especificado pelo parâmetro /Output .
```
SetupDiag.exe /Output:C:\SetupDiag\RecoveryResults.log /LogsPath:D:\Temp\Cabs\PBR_Log /Scenario:Recovery
```
O exemplo a seguir define o cenário de recuperação no modo online. No exemplo, SetupDiag pesquisa logs de redefinição/recuperação no sistema atual e a saída resulta no formato XML.
```
SetupDiag.exe /Scenario:Recovery /Format:xml
```
O exemplo a seguir é um exemplo do Modo Offline. SetupDiag é instruído a analisar arquivos de log de instalação/atualização no diretório LogsPath e gerar os resultados para C:\SetupDiag\Results.txt.
```
SetupDiag.exe /Output:C:\SetupDiag\Results.txt /LogsPath:D:\Temp\Logs\Logs1 /RegPath:HKEY_CURRENT_USER\SYSTEM\SetupDiag
```
O exemplo a seguir é um exemplo do Modo Online. SetupDiag é instruído a procurar logs de instalação/atualização no sistema atual e gerar seus resultados no formato XML para C:\SetupDiag\Results.xml.
```
SetupDiag.exe /Output:C:\SetupDiag\Results.xml /Format:xml
```
O exemplo a seguir é um exemplo do Modo Online em que nenhum parâmetro é necessário ou usado. SetupDiag é instruído a procurar logs de instalação/atualização no sistema atual e gerar os resultados para o mesmo diretório em que o SetupDiag está localizado.
```
SetupDiag.exe
```
O exemplo a seguir é um exemplo do Modo Offline de Redefinição/Recuperação. SetupDiag é instruído a procurar logs de redefinição/recuperação no local de LogsPath especificado. Em seguida, ele gera os resultados para o diretório especificado pelo parâmetro /Output .
```
SetupDiag.exe /Output:C:\SetupDiag\RecoveryResults.log /LogsPath:D:\Temp\Cabs\PBR_Log /Scenario:Recovery
```
O exemplo a seguir é um exemplo de Modo Online de Redefinição/Recuperação. SetupDiag é instruído a procurar logs de redefinição/recuperação no sistema atual e gerar seus resultados no formato XML.
```
SetupDiag.exe /Scenario:Recovery /Format:xml
```

Arquivos de log

Os Arquivos de Log de Instalação do Windows e os Logs de Eventos têm informações sobre onde os logs são criados durante a Instalação do Windows. Para processamento offline, SetupDiag deve ser executado em relação ao conteúdo de toda a pasta. Por exemplo, dependendo de quando a atualização falhou, copie uma das seguintes pastas para o local offline:

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

Se a pasta pai e todas as subpastas forem copiadas, o SetupDiag pesquisará automaticamente arquivos de log em todos os subdiretórios.

Análise de marcar de bugs de instalação

Quando o Microsoft Windows encontra uma condição que compromete a operação segura do sistema, o sistema para. Essa condição é chamada de marcar de bug. Essa condição também é comumente chamada de falha do sistema, erro de kernel, erro de parada ou BSOD. Normalmente, um dispositivo de hardware, um driver de hardware ou um software relacionado causam esse erro.

Se os despejos de falha estiverem habilitados no sistema, um arquivo de despejo de falhas será criado. Se o bug marcar ocorrer durante uma atualização, a Instalação do Windows extrairá um arquivo minidump (setupmem.dmp). SetupDiag também pode depurar esses minidumps relacionados à configuração.

Para depurar um bug relacionado à configuração marcar:

Especifique o parâmetro /LogsPath . Os despejos de memória não podem ser depurados no modo online.
Reúna o arquivo de despejo de memória de instalação ('setupmem.dmp) do sistema com falha.

Setupmem.dmpé criado em %SystemDrive%$Windows.~bt\Sources\Rollback ou em %WinDir%\Panther\NewOS\Rollback dependendo de quando o bug marcar ocorrer.
Instale as Ferramentas de Depuração do Windows no computador que executa o SetupDiag.

No exemplo a seguir, o setupmem.dmp arquivo é copiado para o D:\Dump diretório e as Ferramentas de Depuração do Windows são instaladas antes de executar o SetupDiag:

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

Problemas conhecidos

Algumas regras podem levar muito tempo para serem processadas se os arquivos de log envolvidos forem grandes.

Saída de exemplo

O comando a seguir é um exemplo em que SetupDiag é executado no modo offline.

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

Regras

Quando SetupDiag pesquisa arquivos de log, ele usa um conjunto de regras para corresponder a problemas conhecidos. Essas regras estão contidas em um arquivo xml. O arquivo xml pode ser atualizado com regras novas e atualizadas à medida que novas versões do SetupDiag são disponibilizadas.

Cada nome de regra e seu identificador de regra exclusivo associado são listados com uma descrição do problema conhecido de bloqueio de atualização. Nas descrições da regra, o termo down-level refere-se à primeira fase do processo de atualização, que é executado no sistema operacional original.

Nome da regra	GUID	Descrição
CompatScanOnly	FFDAFD37-DB75-498A-A893-472D49A1311D	Essa regra indica que `setup.exe` foi chamada com um parâmetro de linha de comando específico que indicava que a instalação era apenas para fazer uma verificação de compatibilidade, não uma atualização.
PlugInComplianceBlock	D912150B-1302-4860-91B5-527907D08960	Detecta todos os blocos de compatibilidade dos plug-ins de conformidade do servidor. Essa regra é somente para atualizações de servidor. Ele gera o bloco de conformidade e a correção necessários.
BitLockerHardblock	C30152E2-938E-44B8-915B-D1181BA635AE	Esse bloco é um bloco de atualização quando o sistema operacional de destino não dá suporte ao BitLocker, mas o sistema operacional host tem o BitLocker habilitado.
VHDHardblock	D9ED1B82-4ED8-4DFD-8EC0-BE69048978CC	Esse bloco acontece quando o sistema operacional host é inicializado em uma imagem VHD. Não há suporte para a atualização quando o sistema operacional host é inicializado de uma imagem VHD.
PortableWorkspaceHardblock	5B0D3AB4-212A-4CE4-BDB9-37CA404BB280	Esse bloco indica que o sistema operacional host é inicializado de um dispositivo windows To-Go (chave USB). Não há suporte para atualização no ambiente do Windows To-Go.
AuditModeHardblock	A03BD71B-487B-4ACA-83A0-735B0F3F1A90	Esse bloco indica que o sistema operacional host está inicializado no Modo de Auditoria, um modo especial para modificar o estado do Windows. Não há suporte para atualização desse estado.
SafeModeHardblock	404D9523-B7A8-4203-90AF-5FBB05B6579B	Esse bloco indica que o sistema operacional host é inicializado para o Modo Seguro, onde não há suporte para atualização.
InsufficientSystemPartitionDiskSpaceHardblock	3789FBF8-E177-437D-B1E3-D38B4C4269D1	Esse bloco é encontrado quando a configuração determina que a partição do sistema não tem espaço suficiente para ser atendida com os arquivos de inicialização mais recentes necessários durante o processo de atualização. A partição do sistema é onde os arquivos do carregador de inicialização são armazenados
CompatBlockedApplicationAutoUninstall	BEBA5BC6-6150-413E-8ACE-5E1EC8D34DD5	Essa regra indica que há um aplicativo que precisa ser desinstalado antes que a configuração possa continuar.
CompatBlockedApplicationDismissable	EA52620B-E6A0-4BBC-882E-0686605736D9	Quando a configuração é executada no modo /quiet , há mensagens de aplicativo dispensáveis que se transformam em blocos, a menos que a linha de comando também especifique /compat ignorewarning. Essa regra indica que a configuração foi executada no modo /quiet, mas há uma mensagem de bloco dispensável do aplicativo que impediu que a configuração continuasse.
CompatBlockedFODDismissable	7B693C42-793E-4E9E-A10B-ED0F33D45E2A	Quando a configuração é executada no modo /quiet , há mensagens de recurso sob demanda dispensáveis que se transformam em blocos, a menos que a linha de comando também especifique /compat ignorewarning. Essa regra indica que a configuração foi executada no modo /quiet, mas há uma mensagem de bloco dispensável Recurso sob Demanda que impediu a continuação da configuração, geralmente que a imagem do sistema operacional de destino está ausente de um Recurso sob Demanda instalado no sistema operacional atual. A remoção do recurso sob demanda no sistema operacional atual também deve resolve o problema.
CompatBlockedApplicationManualUninstall	9E912E5F-25A5-4FC0-BEC1-CA0EA5432FF4	Essa regra indica que um aplicativo sem uma entrada de Adicionar/Remover Programas está presente no sistema e impede que a configuração continue. Esse bloco normalmente requer a remoção manual dos arquivos associados a esse aplicativo para continuar.
GenericCompatBlock	511B9D95-C945-4F9B-BD63-98F1465E1CF6	A regra indica que o sistema não atende a um requisito de hardware para executar o Windows. Por exemplo, o dispositivo está ausente de um requisito para o TPM 2.0. Esse problema pode ocorrer mesmo quando é feita uma tentativa de ignorar os requisitos de hardware.
GatedCompatBlock	34A9F145-3842-4A68-987F-4622EE0FC162	Essa regra indica que a atualização falhou devido a um bloco temporário. Um bloco temporário é colocado em prática quando um problema é encontrado com uma parte específica do driver de software ou hardware e o problema tem uma correção pendente. O bloco é levantado depois que a correção estiver amplamente disponível.
HardblockDeviceOrDriver	ED3AEFA1-F3E2-4F33-8A21-184ADF215B1B1B	Esse erro indica que um driver de dispositivo carregado no sistema operacional host não é compatível com a versão mais recente do sistema operacional. O driver do dispositivo precisa ser removido antes da atualização.
HardblockMismatchedLanguage	60BA8449-CF23-4D92-A108-D6FCEFB95B45	Essa regra indica que o sistema operacional host e as edições de linguagem do sistema operacional de destino não correspondem.
HardblockFlightSigning	598F2802-3E7F-4697-BD18-7A6371C8B2F8	Essa regra indica que o sistema operacional de destino é uma versão prévia, o build do Windows Insider e o computador de destino tem a Inicialização Segura habilitada. Essa regra bloqueia o build assinado de pré-lançamento da inicialização se instalado no computador.
DiskSpaceBlockInDownLevel	6080AFAC-892E-4903-94EA-7A17E69E549E549E	Essa falha indica que o sistema ficou sem espaço em disco durante as operações de atualização em nível inferior.
DiskSpaceFailure	981DCBA5-B8D0-4BA7-A8AB-4030F7A10191	Essa falha indica que a unidade do sistema ficou sem espaço em disco disponível em algum momento após a primeira reinicialização na atualização.
PreReleaseWimMountDriverFound	31EC76CC-27EC-4ADC-9869-66AABEDB56F0	Captura falhas devido a ter um driver não reconhecido `wimmount.sys` registrado no sistema.
DebugSetupMemoryDump	C7C63D8A-C5F6-4255-8031-74597773C3C6	Essa regra offline indica apenas um bug marcar ocorreu durante a instalação. Se as ferramentas de depurador estiverem disponíveis no sistema, o SetupDiag depura o despejo de memória e fornece detalhes.
DepuraçãoSetupCrash	CEEBA202-6F04-4BC3-84B8-7B99AED924B1	Essa regra offline somente indica que a configuração em si encontrou uma falha que resultou em um despejo de memória de processo. Se as ferramentas de depurador estiverem instaladas no sistema, o SetupDiag depura o despejo de memória e fornece mais detalhes.
DepurarMemoryDump	505ED489-329A-43F5-B467-FCAAF6A1264C	Essa regra offline é somente para qualquer arquivo de memory.dmp que resultou durante a operação de instalação/atualização. Se as ferramentas de depurador estiverem instaladas no sistema, o SetupDiag depura o despejo de memória e fornece mais detalhes.
DeviceInstallHang	37BB1C3A-4D79-40E8-A556-FDA126D40BC6	Essa regra de falha indica o sistema pendurado ou bug verificado durante a fase de instalação do dispositivo de atualização.
DriverPackageMissingFileFailure	37BB1C3A-4D79-40E8-A556-FDA126D40BC6	Essa regra indica que um pacote de driver tinha um arquivo ausente durante a instalação do dispositivo. Atualizar o pacote de driver pode ajudar a resolve o problema.
UnsignedDriverBootFailure	CD270AA4-C044-4A22-886A-F34EF2E79469	Essa regra indica que um driver sem sinal causou uma falha na inicialização.
BootFailureDetected	4FB446C2-D4EC-40B4-97E2-67EB19D1CFB7	Essa regra indica que ocorreu uma falha de inicialização durante uma fase específica da atualização. A regra indica o código de falha e a fase para fins de diagnóstico.
WinSetupBootFilterFailure	C073BFC8-5810-4E19-B53B-4280B79E096C	Detecta falhas nas operações de arquivo do modo kernel.
FindDebugInfoFromRollbackLog	9600EB68-1120-4A87-9FE9-3A4A70ACFC37	Essa regra determina e fornece detalhes quando ocorre um bug marcar durante o processo de instalação/atualização que resultou em um despejo de memória. No entanto, um pacote de depurador não é necessário no computador de execução.
Falha do AdvancedInstaller	77D36C96-32BE-42A2-BB9C-AAFFE64FCADC	Localiza operações de instalador avançado fatais que causam falhas de instalação. Indica falha crítica no AdvancedInstaller durante a execução de um pacote do instalador, inclui o .exe que está sendo chamado, a fase, o modo, o componente e os códigos de erro.
AdvancedInstallerPluginInstallFailed	2F784A0E-CEB1-47C5-8072-F1294C7CB4AE	Essa regra indica que algum componente que estava sendo instalado por meio de um instalador avançado (FeatureOnDemand, Language Packs, pacotes .NET etc.) não foi instalado. A regra chama o que estava sendo instalado. Se o componente com falha for um FeatureOnDemand, remova o Recurso do Windows, reinicialize e tente a atualização novamente. Se o componente com falha for um Pacote de Idiomas, remova o pacote de idiomas adicional, reinicialize e tente a atualização novamente.
AdvancedInstallerGenericFailure	4019550D-4CAA-45B0-A222-349C48E86F71	Uma regra para corresponder a falhas de leitura/gravação do AdvancedInstaller em um sentido genérico. Dispara em falhas avançadas do instalador em um sentido genérico. Ele gera o aplicativo chamado, fase, modo, componente e código de erro.
FindMigApplyUnitFailure	A4232E11-4043-4A37-9BF4-5901C46FD781	Detecta uma falha na unidade de migração que fez com que a atualização falhasse. Essa regra gera o nome do plug-in de migração e o código de erro que ele produziu para fins de diagnóstico.
FindMigGatherUnitFailure	D04C064B-CD77-4E64-96D6-D26F30B4EE29	Detecta uma falha de unidade de coleta de migração que fez com que a atualização falhasse. Essa regra gera o nome da unidade de coleta/plug-in e o código de erro produzido para fins de diagnóstico.
FindMigGatherApplyFailure	A9964E6C-A2A8-45FF-B6B5-25E0BD71428E	Mostra erros quando o mecanismo de migração falha em uma operação de recolhimento ou aplicação. Indica o objeto Migration (caminho de arquivo ou registro), a Migração
OpcionalComponentFailedToGetOCsFromPackage	D012E2A2-99D8-4A8C-BBB2-088B92083D78	Essa regra corresponde a uma falha específica do Componente Opcional ao tentar enumerar componentes em um pacote. Indica que a operação de migração de OC (componente opcional) falhou ao enumerar componentes opcionais de um Pacote OC. Ele gera o nome do pacote e o código de erro. Essa regra substitui a regra OptionalComponentInstallFailure presente.
OpcionalComponentOpenPackageFailed	22952520-EC89-4FBD-94E0-B67DF88347F6	Corresponde a uma falha de componente opcional específica ao tentar abrir um pacote OC. Ele gera o nome do pacote e o código de erro. Indica que a operação de migração de componente opcional falhou ao abrir um pacote de componente opcional. Gera o nome do pacote e o código de erro.
OpcionalComponentInitCBSSessionFailed	63340812-9252-45F3-A0F2-B2A4CA5E9317	Corresponde a uma falha específica em que o serviço ou componentes avançados do instalador não estão operando ou iniciados no sistema. Indica corrupção na pilha de manutenção no sistema de nível inferior. Gera o código de erro encontrado ao tentar inicializar o componente de manutenção no sistema operacional existente.
CriticalSafeOSDUFailure	73566DF2-CA26-4073-B34C-C9BC70DBF043	Essa regra indica que ocorreu uma falha ao atualizar a imagem do SafeOS com uma atualização dinâmica crítica. Ele indica a fase e o código de erro que ocorreram ao tentar atualizar a imagem SafeOS para fins de diagnóstico.
UserProfileCreationFailureDuringOnlineApply	678117CE-F6A9-40C5-BC9F-A22575C78B14	Indica que houve uma falha crítica ao criar ou modificar um Perfil de Usuário durante a fase de aplicação online da atualização. Ele indica a operação e o código de erro associados à falha para fins de diagnóstico.
UserProfileCreationFailureDuringFinalize	C6677BA6-2E53-4A88-B528-336D15ED1A64	Corresponde a um erro específico de criação do Perfil de Usuário durante a fase de finalização da configuração. Ele gera o código de falha.
UserProfileSuffixMismatch	B4BBCCCE-F99D-43EB-9090-078213397FD8	Detecta quando um arquivo ou outro objeto faz com que a migração ou criação de um perfil de usuário falhe durante a atualização.
DuplicateUserProfileFailure	BD7B3109-80F1-4421-8F0A-B34CD25F4B51	Essa regra indica um erro fatal ao migrar perfis de usuário, geralmente com vários SIDs associados a um único perfil de usuário. Esse erro geralmente ocorre quando o software cria contas de usuário locais com as quais nunca foram usadas ou entraram. A regra indica o SID e o UserName da conta que está causando a falha. Para tentar resolve o problema, primeiro faça backup de todos os arquivos do usuário para a conta de usuário afetada. Após o backup dos arquivos do usuário, exclua a conta de maneira compatível. Verifique se a conta não é uma necessária ou atualmente é usada para entrar no dispositivo. Depois de excluir a conta, reinicialize e tente a atualização novamente.
WimMountFailure	BE6DF2F1-19A6-48C6-AEF8-D3B0CE3D4549	Essa regra indica que a atualização falhou ao montar um arquivo WIM. Ele mostra o nome do arquivo WIM e a mensagem de erro e o código de erro associados à falha para fins de diagnóstico.
WimMountDriverIssue	565B60DD-5403-4797-AE3E-BC5CB972FBAE	Detecta falhas no `WimMount.sys` registro no sistema.
WimApplyExtractFailure	746879E9-C9C5-488C-8D4B-0C811FF3A9A8	Corresponde a uma falha de aplicação de WIM durante as fases de instalação de extração de WIM. Ele gera o código de extensão, caminho e erro.
UpdateAgentExpanderFailure	66E496B3-7D19-47FA-B19B-4040B9FD17E2	Corresponde a falhas do expansor DPX na fase de atualização em nível inferior de Windows Update. Ele gera o nome do pacote, a função, a expressão e o código de erro.
FindFatalPluginFailure	E48E3F1C-26F6-4AFB-859B-BF637DA49636	Corresponde a qualquer falha de plug-in que o setupplatform decide ser fatal para a instalação. Ele gera o nome do plug-in, a operação e o código de erro.
MigrationAbortedDueToPluginFailure	D07A24F6-5B25-474E-B516-A730085940C9	Indica uma falha crítica em um plug-in de migração que faz com que a configuração anule a migração. Fornece a operação de instalação, nome do plug-in, ação de plug-in e código de erro.
DISMAddPackageFailed	6196FF5B-E69E-4117-9EC6-9C1EAB20A3B9	Indica uma falha crítica durante uma operação de pacote de adição de DISM. Especifica o nome do pacote, o erro DISM e o código de erro do pacote.
DISMImageSessionFailure	61B7886B-10CD-4C98-A299-B987CB24A11C	Captura informações de falha quando o DISM não inicia uma sessão de imagem com êxito.
DISMproviderFailure	D76EF86F-B3F8-433F-9EBF-B4411F8141F4	Dispara quando um provedor DISM (plug-in) falha em uma operação crítica. Gera o arquivo (nome do plug-in), função chamada + código de erro e mensagem de erro do provedor.
SysPrepLaunchModuleFailure	7905655C-F295-45F7-8873-81D6F9149BFD	Indica que um plug-in sysPrep falhou em uma operação crítica. Indica o nome do plug-in, o nome da operação e o código de erro.
UserProvidedDriverInjectionFailure	2247C48A-7EE3-4037-AFAB-95B92DE1D980	Um driver fornecido para instalação (por meio de entrada de linha de comando) falhou de alguma forma. Gera a função de instalação do driver e o código de erro.
DriverMigrationFailure	9378D9E2-256E-448C-B02F-137F611F5CE3	Essa regra indica uma falha fatal ao migrar drivers.
UnknownDriverMigrationFailure	D7541B80-5071-42CE-AD14-FBE8C0C4F7FD	Essa regra indica que um pacote de driver ruim reside no sistema. O pacote de driver faz com que a atualização falhe quando o pacote de driver é tentado a migrar para o novo sistema operacional. A regra geralmente indica o nome do pacote do driver que causou o problema. A correção é remover o pacote de driver incorreto, reiniciar e tentar a atualização novamente. Se uma atualização para esse driver estiver disponível no OEM, é recomendável atualizar o pacote de driver.

FindSuccessfulUpgrade	8A0824C8-A56D-4C55-95A0-22751AB62F3E	Determina se a configuração determinada foi um sucesso ou não com base nos logs.
FindSetupHostReportedFailure	6253C04F-2E4E-4F7A-B88E-95A69702F7EC	Fornece informações sobre falhas exibidas no início do processo de atualização por `setuphost.exe`
FindDownlevelFailure	716334B7-F46A-4BAA-94F2-3E31BC9EFA55	Fornece informações de falha exibidas por SetupPlatform, posteriormente na fase de nível inferior.
FindAbruptDownlevelFailure	55882B1A-DA3E-408A-9076-23B22A0472BD	Fornece informações de falha de última operação quando o sistema falha no nível inferior, mas o log acaba abruptamente.
FindEarlyDownlevelError	A4CE4FC9-5E10-4BB1-8ECE-3B29EB9D7C52	Detecta falhas na fase de nível inferior antes de a plataforma de instalação ser invocada.
FindSPFatalError	A4028172-1B09-48F8-AD3B-86CDD7D55852	Captura informações de falha quando a plataforma de configuração encontra um erro fatal.
FindSetupPlatformFailedOperationInfo	307A0133-F06B-4B75-AEA8-116C3B53C2D1	Fornece informações de última fase e erro quando SetupPlatform indica uma falha crítica. Essa regra indica a operação e o erro associados à falha para fins de diagnóstico.
FindRollbackFailure	3A43C9B5-05B3-4F7C-A955-88F991BB5A48	Fornece informações de última operação, fase de falha e erro quando ocorre uma reversão.

Logs de exemplo

Exemplo de log de texto

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://learn.microsoft.com/windows/deployment/upgrade/upgrade-error-codes for error information.

Exemplo de 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.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://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>

Exemplo de 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":"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:\/\/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
}

Chave de registro de exemplo

Exemplo de chave de registro addreg.

Resolver erros de atualização do Windows: informações técnicas para profissionais de TI.

Partilhar via

SetupDiag

Sobre SetupDiag

Requisitos

Usando SetupDiag

Parâmetros

Exemplos

Arquivos de log

Análise de marcar de bugs de instalação

Problemas conhecidos

Saída de exemplo

Regras

Logs de exemplo

Exemplo de log de texto

Exemplo de log XML

Exemplo de log JSON

Chave de registro de exemplo

Comentários

Recursos adicionais

Partilhar via

SetupDiag

Sobre SetupDiag

Requisitos

Usando SetupDiag

Parâmetros

Exemplos

Arquivos de log

Análise de marcar de bugs de instalação

Problemas conhecidos

Saída de exemplo

Regras

Logs de exemplo

Exemplo de log de texto

Exemplo de log XML

Exemplo de log JSON

Chave de registro de exemplo

Artigos relacionados

Comentários

Recursos adicionais