SetupDiag

Aplicável ao

  • Windows 10

Observação

Este é um tópico de nível 300 (avançado moderado).
Consulte Resolver erros de upgrade do Windows 10 para obter uma lista completa de tópicos deste artigo.

 Baixe SetupDiag.

Sobre SetupDiag

Versão atual para download do SetupDiag: 1.6.2107.27002.

Certifique-se sempre de executar a versão mais recente do SetupDiag, de modo que possa acessar novas funcionalidades e correções a problemas conhecidos.

SetupDiag é uma ferramenta de diagnóstico que pode ser usada para obter detalhes sobre por que uma atualização Windows 10 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 Windows 10. SetupDiag pode ser executado no computador que não foi atualizado ou você pode exportar logs do computador para outro local e executar SetupDiag no modo offline.

SetupDiag em Windows 10, versão 2004 e posterior

Com a versão de Windows 10, versão 2004, o SetupDiag está incluído na Configuração do Windows.

Durante o processo de atualização, a Instalação do Windows extrairá todos os seus arquivos de origem para o diretório %SystemDrive%$Windows.~bt\Sources . Com Windows 10, versão 2004 e posterior, setupdiag.exe também é instalado neste diretório. 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 setupdiag resultante pode ser encontrada em %WinDir%\Logs\SetupDiag\SetupDiagResults.xml e no registro em HKLM\SYSTEM\Setup\SetupDiag\Results. Observe que 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 parâmetro /RegPath 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.

Usando SetupDiag

Para usar rapidamente o SetupDiag no computador atual:

  1. Verifique se o sistema atende aos requisitos descritos abaixo. Se necessário, instale o .NET framework 4.6.
  2. Baixe SetupDiag.
  3. Se o navegador da Web perguntar o que fazer com o arquivo, escolha Salvar. Por padrão, o arquivo será salvo na pasta Downloads . Você também pode salvá-lo em um local diferente se desejar usando Salvar Como.
  4. Quando SetupDiag terminar de baixar, abra a pasta em que você baixou o arquivo. Por padrão, essa pasta é a pasta Downloads, que é exibida em Explorador de Arquivos em Acesso rápido no painel de navegação esquerdo.
  5. Clique duas vezes no arquivo SetupDiag para executá-lo. Selecione Sim se você for solicitado a aprovar a execução do programa.
    • Clicar duas vezes no arquivo para executá-lo fechará automaticamente a janela de comando quando SetupDiag tiver concluído sua análise. Se você quiser manter essa janela aberta e revisar as mensagens que você vê, execute o programa digitando SetupDiag no prompt de comando em vez de clicar duas vezes nele. Você precisará alterar diretórios para o local de SetupDiag para executá-lo dessa forma.
  6. Uma janela de comando será aberta enquanto SetupDiag diagnostica seu computador. Aguarde até que esse processo seja concluído.
  7. Quando SetupDiag for concluído, dois arquivos serão criados na mesma pasta em que você clica duas vezes em SetupDiag. Um é um arquivo de configuração, o outro é um arquivo de log.
  8. Use o Bloco de Notas para abrir o arquivo de log: SetupDiagResults.log.
  9. Examine as informações exibidas. Se uma regra foi correspondida, essas informações poderão dizer por que o computador não foi atualizado e, potencialmente, como corrigir o problema. Confira o exemplo de log de texto abaixo.

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

A seção Notas de versão na parte inferior deste artigo tem informações sobre atualizações recentes para esta ferramenta.

Requisitos

  1. O sistema operacional de destino deve ser Windows 10.

  2. .NET Framework 4.6 deve ser instalado. Se você não tiver certeza de qual versão do .NET está instalada no momento, consulte Como determinar quais .NET Framework versões estão instaladas. Você também pode usar a seguinte consulta de linha de comando para exibir as versões do v4 instaladas:

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

Parâmetros

Parâmetro Descrição
/?
  • Exibe ajuda interativa
/Output:<path to results file>
  • Esse parâmetro opcional permite que você especifique o arquivo de saída para obter resultados. Este arquivo é onde você encontrará o que SetupDiag foi capaz de determinar. Há suporte apenas para a saída do formato de texto. Os caminhos UNC funcionarão, desde que o contexto em que o SetupDiag é executado tenha acesso ao caminho UNC. Se o caminho tiver um espaço nele, você deverá incluir todo o caminho em aspas duplas (confira a seção de exemplo abaixo).
  • Padrão: se não for especificado, SetupDiag criará o arquivo SetupDiagResults.log no mesmo diretório em que SetupDiag.exe é executado.
/LogsPath:<Caminho para logs>
  • Esse parâmetro opcional informa SetupDiag.exe 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 pesquisará recursivamente todos os diretórios filho.
/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 que SetupDiag.exe é executado.
  • Padrão: se não for especificado, um valor de 'true' será usado.
/Format:<xml | json>
  • Esse parâmetro opcional pode ser usado para gerar arquivos de log no formato xml ou JSON. Se esse parâmetro não for especificado, o formato de texto será usado por padrão.
/Scenario:[Recovery]
  • Esse parâmetro opcional instrui SetupDiag.exe a procurar e processar logs de redefinição e recuperação e ignorar logs de instalação/atualização.
/Verbose
  • Esse parâmetro opcional produzirá muito mais dados para um arquivo de log. Por padrão, SetupDiag só produzirá uma entrada de arquivo de log para erros graves. O uso de /Verbose fará 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 Microsoft.
/AddReg
  • Este parâmetro opcional instrui SetupDiag.exe a adicionar informações de falha ao registro no modo offline. Por padrão, SetupDiag adicionará informações de falha ao registro somente no modo online. Os dados do registro são adicionados ao seguinte local no sistema em que o SetupDiag é executado: HKLM\SYSTEM\Setup\MoSetup\Volatile\SetupDiag.
/RegPath
  • Esse parâmetro opcional instrui SetupDiag.exe a adicionar informações de falha ao registro usando o caminho especificado. Se esse parâmetro não for especificado, o caminho padrão será HKLM\SYSTEM\Setup\MoSetup\Volatile\SetupDiag.
|

Observação: o parâmetro /Mode é preterido na versão 1.4.0.0 do 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. Na versão 1.4.0.0, quando você especificar /LogsPath, o SetupDiag será 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 (modo online, o arquivo de resultados é SetupDiagResults.log na mesma pasta em que SetupDiag é executado).

SetupDiag.exe

No exemplo a seguir, SetupDiag é executado no modo online (esse modo é o padrão). Ele saberá onde procurar logs no sistema atual (com falha) para que não haja 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 procurará logs de redefinição/recuperação no local do LogsPath especificado e produzirá 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 procurará logs de redefinição/recuperação no sistema atual e resultados de saída 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, você deve executar SetupDiag no 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 você copiar a pasta pai e todas as subpastas, o SetupDiag procurará automaticamente arquivos de log em todos os subdiretórios.

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

Quando Microsoft Windows encontra uma condição que compromete a operação segura do sistema, o sistema para. Essa condição é chamada de verificação de bug. Também é comumente chamado de falha do sistema, erro do 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 a verificação de bug 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 uma verificação de bug relacionada à configuração, você deve:

  • Especifique o parâmetro /LogsPath . Você não pode depurar despejos de memória no modo online.
  • Reúna o arquivo de despejo de memória de instalação (setupmem.dmp) do sistema com falha.
    • Setupmem.dmp será criado em %SystemDrive%$Windows.~bt\Sources\Rollback ou em %WinDir%\Panther\NewOS\Rollback dependendo de quando ocorrer a verificação de bug.
  • Instale as Ferramentas de Depuração do Windows no computador que executa o SetupDiag.

No exemplo a seguir, o arquivo setupmem.dmp é copiado para o diretório D:\Dump 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

  1. 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.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

Regras

Ao pesquisar os arquivos de registro, o SetupDiag usa um conjunto de regras para corresponder aos problemas conhecidos. Essas regras estão contidas no arquivo rules.xml que é extraído quando SetupDiag é executado. O arquivo rules.xml pode ser atualizado à medida que novas versões do SetupDiag forem disponibilizadas. Para obter mais informações, confira a seção notas de versão .

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 "nível inferior" refere-se à primeira fase do processo de atualização, que é executado no sistema operacional inicial.

  1. CompatScanOnly - FFDAFD37-DB75-498A-A893-472D49A1311D
    • Essa regra indica que setup.exe foi chamado 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.
  2. BitLockerHardblock - C30152E2-938E-44B8-915B-D1181BA635AE
    • Esse é 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.
  3. 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.
  4. PortableWorkspaceHardblock - 5B0D3AB4-212A-4CE4-BDB9-37CA404BB280
    • Isso 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.
  5. 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.
  6. 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.
  7. InsufficientSystemPartitionDiskSpaceHardblock - 3789FBF8-E177-437D-B1E3-D38B4C4269D1
    • Esse bloco é encontrado quando a configuração determina que a partição do sistema (em que os arquivos do carregador de inicialização são armazenados) não tem espaço suficiente para ser atendido com os arquivos de inicialização mais recentes necessários durante o processo de atualização.
  8. CompatBlockedApplicationAutoUninstall - BEBA5BC6-6150-413E-8ACE-5E1EC8D34DD5
    • Essa regra indica que há um aplicativo que precisa ser desinstalado antes que a instalação possa continuar.
  9. CompatBlockedApplicationDismissable - EA52620B-E6A0-4BBC-882E-0686605736D9
    • Ao executar a configuração no modo /silencioso, 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.
  10. 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. Isso normalmente requer a remoção manual dos arquivos associados a esse aplicativo para continuar.
  11. 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 e precisa ser removido antes da atualização.
  12. 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.
  13. 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. Isso bloqueará o build assinado pela pré-lançamento da inicialização se instalado no computador.
  14. 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.
  15. 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.
  16. 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.
  17. DebugSetupMemoryDump - C7C63D8A-C5F6-4255-8031-74597773C3C6
    • Essa regra offline indica que ocorreu uma verificação de bug durante a instalação. Se as ferramentas de depurador estiverem disponíveis no sistema, o SetupDiag depurará o despejo de memória e fornecerá detalhes.
  18. DebugSetupCrash - 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 depurará o despejo de memória e fornecerá mais detalhes.
  19. DebugMemoryDump - 505ED489-329A-43F5-B467-FCAAF6A1264C
    • Essa regra offline é somente para qualquer arquivo memory.dmp que resultou durante a operação de instalação/atualização. Se as ferramentas de depurador estiverem instaladas no sistema, o SetupDiag depurará o despejo de memória e fornecerá mais detalhes.
  20. 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 indicará o código de falha e a fase para fins de diagnóstico.
  21. FindDebugInfoFromRollbackLog - 9600EB68-1120-4A87-9FE9-3A4A70ACFC37
    • Essa regra determinará e fornecerá detalhes quando ocorrer uma verificação de bug durante o processo de instalação/atualização que resultou em um despejo de memória, mas sem a exigência de que o pacote de depurador esteja no computador de execução.
  22. AdvancedInstallerFailed - 77D36C96-32BE-42A2-BB9C-AAFFE64FCADC
    • Localiza operações de instalador avançado fatais que causam falhas de instalação.
  23. FindMigApplyUnitFailure - A4232E11-4043-4A37-9BF4-5901C46FD781
    • Detecta uma falha na unidade de migração que fez com que a atualização falhasse. Essa regra produzirá o nome do plug-in de migração e o código de erro produzido para fins de diagnóstico.
  24. 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 produzirá o nome da unidade de coleta/plug-in e o código de erro produzido para fins de diagnóstico.
  25. CriticalSafeOSDUFailure - 73566DF2-CA26-4073-B34C-C9BC70DBF043
    • Essa regra indica que ocorreu uma falha ao atualizar a imagem SafeOS com uma atualização dinâmica crítica. Ele indicará a fase e o código de erro que ocorreram ao tentar atualizar a imagem SafeOS para fins de diagnóstico.
  26. 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 indicará a operação e o código de erro associados à falha para fins de diagnóstico.
  27. WimMountFailure - BE6DF2F1-19A6-48C6-AEF8-D3B0CE3D4549
    • Essa regra indica que a atualização falhou ao montar um arquivo WIM. Ele mostrará o nome do arquivo WIM e a mensagem de erro e o código de erro associados à falha para fins de diagnóstico.
  28. FindSuccessfulUpgrade - 8A0824C8-A56D-4C55-95A0-22751AB62F3E
    • Determina se a configuração determinada foi um sucesso ou não com base nos logs.
  29. FindSetupHostReportedFailure - 6253C04F-2E4E-4F7A-B88E-95A69702F7EC
    • Fornece informações sobre falhas exibidas no início do processo de atualização por setuphost.exe
  30. FindDownlevelFailure - 716334B7-F46A-4BAA-94F2-3E31BC9EFA55
    • Fornece informações de falha exibidas por SetupPlatform, posteriormente na fase de nível inferior.
  31. 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.
  32. FindSetupPlatformFailedOperationInfo - 307A0133-F06B-4B75-AEA8-116C3B53C2D1
    • Fornece informações de última fase e erro quando SetupPlatform indica uma falha crítica. Essa regra indicará a operação e o erro associados à falha para fins de diagnóstico.
  33. FindRollbackFailure - 3A43C9B5-05B3-4F7C-A955-88F991BB5A48
    • Fornece informações de última operação, fase de falha e erro quando ocorre uma reversão.
  34. AdvancedInstallerGenericFailure - 4019550D-4CAA-45B0-A222-349C48E86F71
    • Uma regra para corresponder a falhas de leitura/gravação do AdvancedInstaller em um sentido genérico. Produzirá o executável que está sendo chamado, bem como o código de erro e o código de saída relatados.
  35. OptionalComponentFailedToGetOCsFromPackage - D012E2A2-99D8-4A8C-BBB2-088B92083D78 (OBSERVAÇÃO: essa regra substitui a regra OptionalComponentInstallFailure presente na v1.10.
    • Isso corresponde a uma falha específica do Componente Opcional ao tentar enumerar componentes em um pacote. Produzirá o nome do pacote e o código de erro.
  36. OptionalComponentOpenPackageFailed - 22952520-EC89-4FBD-94E0-B67DF88347F6
    • Corresponde a uma falha de componente opcional específica ao tentar abrir um pacote OC. Produzirá o nome do pacote e o código de erro.
  37. OptionalComponentInitCBSSessionFailed - 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. Produzirá o código de erro.
  38. 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. Produzirá o código de falha.
  39. WimApplyExtractFailure - 746879E9-C9C5-488C-8D4B-0C811FF3A9A8
    • Corresponde a uma falha de aplicação de WIM durante as fases de instalação da extração de WIM. Produzirá o código de extensão, caminho e erro.
  40. UpdateAgentExpanderFailure - 66E496B3-7D19-47FA-B19B-4040B9FD17E2
    • Corresponde a falhas de expansor DPX na fase de atualização em nível inferior de Windows Update. Produzirá o nome do pacote, a função, a expressão e o código de erro.
  41. FindFatalPluginFailure - E48E3F1C-26F6-4AFB-859B-BF637DA49636
    • Corresponde a qualquer falha de plug-in que o setupplatform decide ser fatal para a instalação. Produzirá o nome do plug-in, a operação e o código de erro.
  42. AdvancedInstallerFailed - 77D36C96-32BE-42A2-BB9C-AAFFE64FCADC
    • 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.
  43. 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. Fornecerá a operação de instalação, nome do plug-in, ação de plug-in e código de erro.
  44. DISMAddPackageFailed - 6196FF5B-E69E-4117-9EC6-9C1EAB20A3B9
    • Indica uma falha crítica durante uma operação de pacote de adição de DISM. Especificará o nome do pacote, o erro DISM e o código de erro do pacote.
  45. PlugInComplianceBlock - D912150B-1302-4860-91B5-527907D08960
    • Detecta todos os blocos de compatibilidade dos plug-ins de conformidade do servidor. Gera as informações e a correção do bloco.
  46. AdvancedInstallerGenericFailure - 4019550D-4CAA-45B0-A222-349C48E86F71
    • Dispara em falhas avançadas do instalador em um sentido genérico, gerando o aplicativo chamado, fase, modo, componente e código de erro.
  47. 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
  48. OptionalComponentFailedToGetOCsFromPackage - D012E2A2-99D8-4A8C-BBB2-088B92083D78
    • Indica que a operação de migração de OC (componente opcional) falhou ao enumerar componentes opcionais de um Pacote OC. Gera o nome do pacote e o código de erro.
  49. OptionalComponentOpenPackageFailed - 22952520-EC89-4FBD-94E0-B67DF88347F6
    • 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.
  50. OptionalComponentInitCBSSessionFailed - 63340812-9252-45F3-A0F2-B2A4CA5E9317
    • 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.
  51. 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.
  52. 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.
  53. 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.
  54. PlugInComplianceBlock - D912150B-1302-4860-91B5-527907D08960
    • Elas são apenas para atualizações de servidor, produzirão o bloco de conformidade e a correção necessários.
  55. PreReleaseWimMountDriverFound - 31EC76CC-27EC-4ADC-9869-66AABEDB56F0
    • Captura falhas devido a ter um driver de wimmount.sys não reconhecido registrado no sistema.
  56. WinSetupBootFilterFailure - C073BFC8-5810-4E19-B53B-4280B79E096C
    • Detecta falhas nas operações de arquivo do modo kernel.
  57. WimMountDriverIssue - 565B60DD-5403-4797-AE3E-BC5CB972FBAE
    • Detecta falhas no registro de WimMount.sys no sistema.
  58. DISMImageSessionFailure - 61B7886B-10CD-4C98-A299-B987CB24A11C
    • Captura informações de falha quando o DISM não inicia uma sessão de imagem com êxito.
  59. FindEarlyDownlevelError - A4CE4FC9-5E10-4BB1-8ECE-3B29EB9D7C52
    • Detecta falhas na fase de nível inferior antes de a plataforma de instalação ser invocada.
  60. FindSPFatalError - A4028172-1B09-48F8-AD3B-86CDD7D55852
    • Captura informações de falha quando a plataforma de configuração encontra um erro fatal.
  61. 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.

Notas de versão

27/07/2021 – SetupDiag v1.6.2107.27002 é lançado com 61 regras, como uma ferramenta autônoma disponível no Centro de Download.

  • Esta versão contém atualizações de conformidade e pequenas correções de bugs.
  • Com essa versão e versões subsequentes, o número de versão da ferramenta SetupDiag para download é diferente daquela incluída na Configuração do Windows.

06/05/2021 – SetupDiag v1.6.1.0 é lançado com 61 regras, como uma ferramenta autônoma disponível no Centro de Download.

  • Esta versão do SetupDiag está incluída com Windows 10, versão 21H1.
  • Uma nova regra é adicionada: UserProfileSuffixMismatch.
  • Todas as saídas para a linha de comando agora são cultura invariável para fins de formato de hora/data
  • Corrigimos um problema com a saída do registro em que o resultado "sem correspondência encontrada" causava um valor REG_SZ corrompido.

08/08/2019 – SetupDiag v1.6.0.42 é lançado com 60 regras, como uma ferramenta autônoma disponível no Centro de Download.

  • O desempenho de detecção de log é aprimorado. A detecção de log leva cerca de 10 segundos ou menos onde antes que possa levar até um minuto.
  • Adicionaram informações sobre a Operação de Instalação e a Fase de Instalação ao log de resultados e às informações do registro.
    • Esta é a última Operação e Fase em que a Instalação estava quando a falha ocorreu.
  • Adicionamos informações detalhadas sobre a Operação de Instalação e a Fase de Instalação (e o tempo) ao log de saída quando /verbose é especificado.
    • Observação: se o problema encontrado for um bloco de compatibilidade, nenhuma informação de Operação de Instalação ou Fase ainda existirá e, portanto, não estará disponível.
  • Adicionamos mais informações à saída do Registro.
    • Informações detalhadas de 'FailureData' quando disponíveis. Exemplo: "AppName = MyBlockedApplication" ou "DiskSpace = 6603" (em MB)
      • Dados "Key = Value" específicos para a falha encontrada.
    • Adicionados 'UpgradeStartTime', 'UpgradeEndTime' e 'UpgradeElapsedTime'
    • Adicionado 'SetupDiagVersion', 'DateTime' (para indicar quando SetupDiag foi executado no sistema), 'TargetOSVersion', 'HostOSVersion' e muito mais...

19/06/2019 – SetupDiag v1.5.0.0 é lançado com 60 regras, como uma ferramenta autônoma disponível no Centro de Download.

  • Todas as saídas de data e hora são atualizadas para formato localizado por solicitação de usuário.
  • Adicionaram informações de operação e fase de instalação ao log /verbose.
  • Adicionaram a última Operação de Instalação e as últimas informações da Fase de Instalação à maioria das regras em que faz sentido (confira nova saída abaixo).
  • Melhoria de desempenho na pesquisa de setupact.logs para determinar o log correto a ser analisado.
  • O número da versão do SetupDiag foi adicionado ao relatório de texto (xml e json sempre o tinham).
  • Adicionados relatórios "sem correspondência" para xml e json por solicitação de usuário.
  • Saída Json formatada para fácil legibilidade.
  • Melhorias de desempenho ao pesquisar logs de configuração; isso deve ser muito mais rápido agora.
  • Foram adicionadas sete novas regras: PlugInComplianceBlock, PreReleaseWimMountDriverFound, WinSetupBootFilterFailure, WimMountDriverIssue, DISMImageSessionFailure, FindEarlyDownlevelError e FindSPFatalError. Consulte a seção Regras acima para obter mais informações.
  • As informações de diagnóstico agora são saída para o registro em HKLM\SYSTEM\Setup\MoSetup\Volatile\SetupDiag
    • O comando /AddReg foi adicionado para alternar a saída do registro. Essa configuração está desativada por padrão para o modo offline e ativada por padrão para o modo online. O comando não tem efeito para o modo online e habilita a saída do registro para o modo offline.
    • Essa chave do registro é excluída assim que SetupDiag é executada pela segunda vez e substituída por dados atuais, portanto, ela está sempre atualizada.
    • Essa chave do registro também é excluída quando uma nova instância de atualização é invocada.
    • Para obter um exemplo, consulte Exemplo de chave do registro.

17/05/2019 – SetupDiag v1.4.1.0 é lançado com 53 regras, como uma ferramenta autônoma disponível no Centro de Download.

  • Essa versão dds a capacidade de encontrar e diagnosticar falhas de redefinição e recuperação (Redefinição de botão por botão).

18/12/2018 – SetupDiag v1.4.0.0 é lançado com 53 regras, como uma ferramenta autônoma disponível no Centro de Download.

  • Esta versão inclui grandes melhorias no desempenho do processamento de regras: ~3x desempenho de processamento de regra mais rápido!
    • A regra FindDownlevelFailure é até 10 vezes mais rápida.
  • Novas regras foram adicionadas para analisar falhas de atualização para Windows 10 versão 1809.
  • Um novo link de ajuda está disponível para resolver falhas de pilha de manutenção no sistema operacional de nível inferior quando a correspondência de regra indica esse tipo de falha.
  • Removeu a necessidade de especificar o parâmetro /Mode. Agora, se você especificar /LogsPath, ele assume automaticamente o modo offline.
  • Algumas melhorias funcionais e de saída foram feitas para várias regras.

16/07/2018 – SetupDiag v1.3.1 é lançado com 44 regras, como uma ferramenta autônoma disponível no Centro de Download.

  • Essa versão corrige um problema que pode ocorrer ao executar o SetupDiag no modo online em um computador que produz um arquivo setupmem.dmp, mas não tem binários de depurador instalados.

07/10/2018 – SetupDiag v1.30 é lançado com 44 regras, como uma ferramenta autônoma disponível no Centro de Download.

  • Correção de bug para uma regra de plug-in supercompar. A regra agora corresponderá corretamente apenas a problemas críticos de plug-in (falha de instalação).
  • Novo recurso: capacidade de gerar logs no formato JSON e XML.
    • Use parâmetros de linha de comando "/Format:xml" ou "/Format:json" para especificar o novo formato de saída. Consulte logs de exemplo na parte inferior deste tópico.
    • Se o parâmetro "/Format:xml" ou "/Format:json" for omitido, o formato de saída de log será padrão para texto.
  • Novo recurso: sempre que possível, instruções específicas agora são fornecidas na saída da regra para reparar o erro identificado. Por exemplo, instruções são fornecidas para corrigir problemas de bloqueio conhecidos, como desinstalar um aplicativo incompatível ou liberar espaço na unidade do sistema.
  • Três novas regras adicionadas: AdvancedInstallerFailed, MigrationAbortedDueToPluginFailure, DISMAddPackageFailed.

30/05/2018 – SetupDiag v1.20 é lançado com 41 regras, como uma ferramenta autônoma disponível no Centro de Download.

  • Corrigimos um bug na detecção de falha da instalação do dispositivo no modo online.
  • SetupDiag alterado para funcionar sem uma instância de setupact.log. Anteriormente, SetupDiag exigia pelo menos um setupact.log para operar. Essa alteração permite que a ferramenta analise falhas de atualização que ocorrem antes de chamar SetupHost.
  • A telemetria é refatorada para enviar apenas o nome da regra e GUID (ou "NoRuleMatched" se nenhuma regra for correspondida) e a Configuração360 ReportId. Essa alteração garante a privacidade dos dados durante o processamento de regras.

02/05/2018 – SetupDiag v1.10 é lançado com 34 regras, como uma ferramenta autônoma disponível no Centro de Download.

  • Um aprimoramento de desempenho foi adicionado para resultar em processamento de regras mais rápido.
  • A saída de regras agora inclui links para artigos de suporte, se aplicável.
  • O SetupDiag agora fornece o caminho e o nome dos arquivos que está processando.
  • Agora você pode executar o SetupDiag selecionando-o e examinando o arquivo de log de saída.
  • Um arquivo de log de saída é sempre criado, se uma regra foi correspondida ou não.

30/03/2018 – SetupDiag v1.00 é lançado com 26 regras, como uma ferramenta autônoma disponível no Centro de Download.

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/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.

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.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>

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":"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
}

Chave de registro de exemplo

Exemplo de Addreg.

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