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 baixável de SetupDiag: 1.6.2107.27002.

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

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

SetupDiag funciona examinando os arquivos Windows de log de Instalação. Ele tenta analisar esses arquivos de log para determinar a causa raiz de uma falha ao atualizar ou atualizar o computador para Windows 10. SetupDiag pode ser executado no computador que falhou na atualização ou você pode exportar logs do computador para outro local e executar SetupDiag no modo offline.

SetupDiag no Windows 10, versão 2004 e posterior

Com o lançamento do Windows 10, versão 2004, SetupDiag está incluído no Windows Instalação.

Durante o processo de atualização, a instalação do Windows extrairá todos os arquivos de origem para o diretório %SystemDrive%$Windows.~bt\Sources. Com Windows 10, versão 2004 e posterior, setupdiag.exetambém está instalado nesse diretório. Se houver um problema com a atualização, SetupDiag será executado automaticamente para determinar a causa da falha.

Quando executado por 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 isso 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 a primeira.

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

Usando SetupDiag

Para usar o SetupDiag rapidamente no computador atual:

  1. Verifique se seu 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 desejado usando Salvar como.
  4. Quando SetupDiag terminar de baixar, abra a pasta onde você baixou o arquivo. Por padrão, essa pasta é a pasta Downloads, que é exibida no Explorador de Arquivos em Acesso rápido no painel de navegação esquerdo.
  5. Clique duas vezes no arquivo SetupDiag para ser executado. Clique em Sim se for solicitado a aprovar a execução do programa.
    • Clicar duas vezes no arquivo para executar ele 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 os diretórios para o local de SetupDiag para ser executado dessa maneira.
  6. Uma janela de comando será aberta enquanto SetupDiag diagnosticar seu computador. Aguarde até que esse processo seja final.
  7. Quando SetupDiag terminar, dois arquivos serão criados na mesma pasta em que você clicou duas vezes em SetupDiag. Um é um arquivo de configuração, o outro é um arquivo de log.
  8. Use Bloco de notas para abrir o arquivo de log: SetupDiagResults.log.
  9. Revise as informações exibidas. Se uma regra foi corresponder, essas informações podem dizer por que o computador falhou na atualização e, potencialmente, como corrigir o problema. Consulte 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, consulte as seções Parâmetros e Exemplos abaixo.

A seção Notas de versão na parte inferior deste tópico 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 How to: Determine Which .NET Framework Versions Are Installed. Você também pode usar a seguinte consulta de linha de comando para exibir as versões 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 resultados. Este arquivo é onde você encontrará o que SetupDiag foi capaz de determinar. Somente a saída de formato de texto é suportada. Os caminhos UNC funcionarão, desde que o contexto em que SetupDiag seja executado tenha acesso ao caminho UNC. Se o caminho tiver um espaço nele, você deverá colocar todo o caminho entre aspas duplas (consulte 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:<Path to logs>
  • Este parâmetro opcional informa SetupDiag.exe onde encontrar os arquivos de log para uma análise offline. Esses arquivos de log podem estar em um formato de pasta simples ou com vários subdireários. SetupDiag pesquisará recursivamente todos os diretórios filho.
/ZipLogs:<True | False>
  • Esse parâmetro opcional diz 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, será usado um valor de "true".
/Format:<xml | json>
  • Esse parâmetro opcional pode ser usado para arquivos de log de saída no formato xml ou JSON. Se esse parâmetro não for especificado, o formato de texto será usado por padrão.
/Scenario:[Recovery]
  • Este parâmetro opcional instrui SetupDiag.exe procurar e processar logs de redefinição e recuperação e ignorar logs de configuração/atualização.
/Verbose
  • Esse parâmetro opcional irá dar muito mais dados a um arquivo de log. Por padrão, SetupDiag produzirá apenas uma entrada de arquivo de log para erros graves. Usar /Verbose fará com que 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.
/AddReg
  • Este parâmetro opcional instrui SetupDiag.exe adicionar informações de falha ao Registro no modo offline. Por padrão, SetupDiag adicionará informações de falha somente ao Registro no modo online. Os dados do Registro são adicionados ao seguinte local no sistema em que SetupDiag é executado: HKLM\SYSTEM\Setup\MoSetup\Volatile\SetupDiag.
/RegPath
  • Este parâmetro opcional instrui SetupDiag.exe 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 de SetupDiag.

  • Em versões anteriores, esse comando foi usado com o parâmetro LogsPath para especificar que SetupDiag deve ser executado offlinemente 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, 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, 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 sabe onde procurar logs no sistema atual (com falha), portanto, não é necessário 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 os resultados serão produzidos no 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

Windows Arquivos de Log de Instalação e Logs de Eventos tem informações sobre onde os logs são criados durante Windows Instalação. Para processamento offline, você deve executar SetupDiag 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 seu 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, SetupDiag procurará automaticamente arquivos de log em todos os subdiretores.

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

Quando a 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 bugs. Também é comumente chamado de falha do sistema, um erro de kernel, um erro stop ou BSOD. Normalmente, um dispositivo de hardware, driver de hardware ou software relacionado causa esse erro.

Se os despejos de falha estão habilitados no sistema, um arquivo de despejo de falha é criado. Se a verificação de bugs ocorrer durante uma atualização, Windows Instalação extrairá um arquivo de minidump (setupmem.dmp). SetupDiag também pode depurar esses minidumps relacionados à instalação.

Para depurar uma verificação de bug relacionada à instalação, você deve:

  • Especifique o parâmetro /LogsPath. Não é possível 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\Rollbackou em %WinDir%\Panther\NewOS\Rollback, dependendo de quando ocorrer a verificação de bugs.
  • Instale o Windows Ferramentas de Depuração 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 SetupDiag:

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

Problemas conhecidos

  1. Algumas regras podem levar muito tempo para processar se os arquivos de log envolvidos são 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 rules.xml arquivo pode ser atualizado à medida que novas versões do SetupDiag são disponibilizadas. Consulte a seção notas de versão para obter mais informações.

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
    • Esta 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 fazer uma verificação depata, 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 para uma imagem VHD. A atualização não é suportada 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 a partir de um dispositivo Windows To-Go (chave USB). A atualização não é suportada no Windows To-Go ambiente.
  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 Windows. A atualização não é suportada desse estado.
  6. SafeModeHardblock - 404D9523-B7A8-4203-90AF-5FBB05B6579B
    • Esse bloco indica que o sistema operacional host é inicializado no modo Cofre, onde a atualização não é suportada.
  7. InsufficientSystemPartitionDiskSpaceHardblock - 3789FBF8-E177-437D-B1E3-D38B4C4269D1
    • Esse bloco é encontrado quando a instalação determina a partição do sistema (onde os arquivos do carregador de inicialização estão armazenados) não tem espaço suficiente para ser atendido com os arquivos de inicialização mais novos necessários durante o processo de atualização.
  8. CompatBlockedApplicationAutoUninstall – BEBA5BC6-6150-413E-8ACE-5E1EC8D34DD5
    • Esta 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 instalação no modo /quiet, há mensagens de aplicativo não permitidas que se transformam em blocos, a menos que a linha de comando também especifique "/compat ignorewarning". Esta regra indica que a instalação foi executada no modo /quiet, mas há uma mensagem de bloqueio de indeferível de aplicativo que impediu a instalação de continuar.
  10. CompatBlockedApplicationManualUninstall - 9E912E5F-25A5-4FC0-BEC1-CA0EA5432FF4
    • Esta regra indica que um aplicativo sem uma entrada Adicionar/Remover Programas está presente no sistema e impede que a instalação continue. Normalmente, isso requer a remoção manual dos arquivos associados a esse aplicativo para continuar.
  11. HardblockDeviceOrDriver - ED3AEFA1-F3E2-4F33-8A21-184ADF215B1B
    • 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
    • Esta regra indica que o sistema operacional host e as edições de idioma do sistema operacional de destino não são corresponderem.
  13. HardblockFlightSigning - 598F2802-3E7F-4697-BD18-7A6371C8B2F8
    • Esta regra indica que o sistema operacional de destino é uma versão prévia, Windows insider, e o computador de destino tem Inicialização Segura habilitada. Isso bloqueará a inicialização da com build assinada de pré-lançamento se estiver instalada no computador.
  14. DiskSpaceBlockInDownLevel - 6080AFAC-892E-4903-94EA-7A17E69E549E
    • Essa falha indica que o sistema ficou sem espaço em disco durante as operações de nível inferior da atualização.
  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 com falha ou erro verificado durante a fase de instalação do dispositivo da atualização.
  17. DebugSetupMemoryDump - C7C63D8A-C5F6-4255-8031-74597773C3C6
    • Esta regra somente offline indica que ocorreu uma verificação de bugs durante a instalação. Se as ferramentas de depurador estão disponíveis no sistema, SetupDiag depurará o despejo de memória e fornecerá detalhes.
  18. DebugSetupCrash - CEEBA202-6F04-4BC3-84B8-7B99AED924B1
    • Essa única regra offline indica que a própria instalação encontrou uma falha que resultou em um despejo de memória do processo. Se as ferramentas de depurador estão instaladas no sistema, SetupDiag depurará o despejo de memória e dará 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 estão instaladas no sistema, SetupDiag depurará o despejo de memória e dará mais detalhes.
  20. BootFailureDetected - 4FB446C2-D4EC-40B4-97E2-67EB19D1CFB7
    • Esta 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
    • Esta regra determinará e dará detalhes quando ocorrer uma verificação de bugs durante o processo de instalação/atualização que resultou em um despejo de memória, mas sem o requisito do pacote de depurador estar no computador de execução.
  22. AdvancedInstallerFailed - 77D36C96-32BE-42A2-BB9C-AAFFE64FCADC
    • Localiza operações de instalador avançado fatais que causam falhas de configuração.
  23. FindMigApplyUnitFailure - A4232E11-4043-4A37-9BF4-5901C46FD781
    • Detecta uma falha na unidade de migração que causou a falha da atualização. Essa regra gerará o nome do plug-in de migração, bem como o código de erro que ele produziu para fins de diagnóstico.
  24. FindMigGatherUnitFailure - D04C064B-CD77-4E64-96D6-D26F30B4EE29
    • Detecta uma falha de unidade de coleta de migração que causou a falha da atualização. Esta regra produzirá o nome da unidade de coleta/plug-in, bem como o código de erro produzido para fins de diagnóstico.
  25. CriticalSafeOSDUFailure - 73566DF2-CA26-4073-B34C-C9BC70DBF043
    • Esta 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 ocorreu 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 associado à falha para fins de diagnóstico.
  27. WimMountFailure - BE6DF2F1-19A6-48C6-AEF8-D3B0CE3D4549
    • Esta regra indica que a atualização falhou ao montar um arquivo wim. Ele mostrará o nome do arquivo wim, bem como a mensagem de erro e o código de erro associado à 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 baseada nos logs.
  29. FindSetupHostReportedFailure - 6253C04F-2E4E-4F7A-B88E-95A69702F7EC
    • Fornece informações sobre falhas que surgiram no início do processo de atualização por setuphost.exe
  30. FindDownlevelFailure - 716334B7-F46A-4BAA-94F2-3E31BC9EFA55
    • Fornece informações de falha que surgiram por SetupPlatform, posteriormente na fase de nível inferior.
  31. FindAbruptDownlevelFailure - 55882B1A-DA3E-408A-9076-23B22A0472BD
    • Fornece informações de falha na última operação quando o sistema falha no nível inferior, mas o log termina abruptamente.
  32. FindSetupPlatformFailedOperationInfo - 307A0133-F06B-4B75-AEA8-116C3B53C2D1
    • Fornece informações de última fase e erro quando SetupPlatform indica uma falha crítica. Esta 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 reaçã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. Fará com que o executável seja chamado, bem como o código de erro e o código de saída relatado.
  35. OptionalComponentFailedToGetOCsFromPackage – D012E2A2-99D8-4A8C-BBB2-088B92083D78 (OBSERVAÇÃO: essa regra substitui a regra OptionalComponentInstallFailure presente em v1.10.
    • Isso corresponde a uma falha de Componente Opcional específica ao tentar enumerar componentes em um pacote. Será produzido 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. Será produzido 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. Dará saída ao 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 instalação. Dará saída ao código de falha.
  39. WimApplyExtractFailure – 746879E9-C9C5-488C-8D4B-0C811FF3A9A8
    • Corresponde a uma falha de aplicação de wim durante as fases de extração wim da instalação. Dará saída à extensão, caminho e código de erro.
  40. UpdateAgentExpandroFailure – 66E496B3-7D19-47FA-B19B-4040B9FD17E2
    • Corresponde às falhas do expansador DPX na fase de baixo nível de atualização do WU. Dará saída ao nome do pacote, função, expressão e código de erro.
  41. FindFatalPluginFailure – E48E3F1C-26F6-4AFB-859B-BF637DA49636
    • Corresponde a qualquer falha de plug-in que o setupplatform decida ser fatal para a instalação. Será produzido 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 instalação anula a migração. Fornecerá a operação de instalação, o nome do plug-in, a ação do plug-in e o código de erro.
  44. DISMAddPackageFailed - 6196FF5B-E69E-4117-9EC6-9C1EAB20A3B9
    • Indica uma falha crítica durante uma operação de pacote de complemento do DISM. Especificará o nome do pacote, o erro DISM e adicionará o código de erro do pacote.
  45. PlugInComplianceBlock - D912150B-1302-4860-91B5-527907D08960
    • Detecta todos os blocos depata dos plug-ins de conformidade do servidor. Saída das informações de bloqueio e correção.
  46. AdvancedInstallerGenericFailure - 4019550D-4CAA-45B0-A222-349C48E86F71
    • Dispara falhas avançadas do instalador em um sentido genérico, saída do 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 coleta ou aplicação. Indica o objeto Migration (arquivo ou caminho do Registro), a Migração
  48. OptionalComponentFailedToGetOCsFromPackage - D012E2A2-99D8-4A8C-BBB2-088B92083D78
    • Indica que a operação de migração do componente opcional (OC) falhou ao enumerar componentes opcionais de um Pacote OC. Saídas 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. Saídas 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. Faz com que 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 de DISM (plug-in) falha em uma operação crítica. Saídas do 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 a instalação (por meio da entrada de linha de comando) falhou de alguma forma. Saídas a função de instalação do driver e o código de erro.
  54. PlugInComplianceBlock - D912150B-1302-4860-91B5-527907D08960
    • Essas são apenas para atualizações de servidor, que terão o bloco de conformidade e a correção necessárias.
  55. PreReleaseWimMountDriverFound - 31EC76CC-27EC-4ADC-9869-66AABEDB56F0
    • Captura falhas devido a um driver wimmount.sys não 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 WimMount.sys registro no sistema.
  58. DISMImageSessionFailure - 61B7886B-10CD-4C98-A299-B987CB24A11C
    • Captura informações de falha quando o DISM falha ao iniciar uma sessão de imagem com êxito.
  59. FindEarlyDownlevelError - A4CE4FC9-5E10-4BB1-8ECE-3B29EB9D7C52
    • Detecta falhas na fase de baixo nível antes que a plataforma de instalação seja invocada.
  60. FindSPFatalError - A4028172-1B09-48F8-AD3B-86CDD7D55852
    • Captura informações de falha quando a plataforma de instalaçã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 a 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 na Central de Download.

  • Esta versão contém atualizações de conformidade e correções de bugs secundárias.
  • Com essa versão e versões subsequentes, o número de versão da ferramenta SetupDiag baixável é diferente do incluído na instalação Windows download.

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

  • Esta versão do SetupDiag está incluída Windows 10 versão 21H1.
  • Uma nova regra é adicionada: UserProfileSuffixMismatch.
  • Todas as saídas para a linha de comando agora são cultura invariante para fins de formato de data/hora
  • Corrigido um problema com a saída do Registro na qual o resultado "nenhuma combinação encontrada" causou 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 na Central de Download.

  • O desempenho da detecção de log é aprimorado. O que costumava levar até um minuto deve levar cerca de 10 segundos ou menos.
  • Adicionadas informações de Operação de Instalação e 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 ocorreu a falha.
  • Adicionadas informações detalhadas de Operação de Instalação e Fase de Instalação (e tempo) ao log de saída quando /verbose for especificado.
    • Observação: se o problema encontrado for um bloco depat, nenhuma informação de Operação de Instalação ou Fase ainda existirá e, portanto, não estará disponível.
  • Adicionada 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 da falha encontrada.
    • Adicionado '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 na Central de Download.

  • Todas as saídas de data e hora são atualizadas para o formato localizado por solicitação do usuário.
  • Adicionadas informações de Operação e Fase de instalação ao log /verbose.
  • Adicionadas informações da última Operação de Instalação e da última Fase de Instalação à maioria das regras em que faz sentido (consulte a nova saída abaixo).
  • Melhoria de desempenho na pesquisa setupact.logs para determinar o log correto para análise.
  • Adicionado o número de versão setupDiag ao relatório de texto (xml e json sempre o tiveram).
  • Adicionados relatórios "nenhuma combinação" para xml e json por solicitação do usuário.
  • Saída Json formatada para fácil leitura.
  • Melhorias de desempenho ao pesquisar logs de instalação; isso deve ser muito mais rápido agora.
  • Foram adicionadas 7 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ídas para o Registro em HKLM\SYSTEM\Setup\MoSetup\Volatile\SetupDiag
    • O comando /AddReg foi adicionado à saída do Registro de alternância. Essa configuração está desativada por padrão para o modo offline e 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 é executado uma segunda vez e substituído 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 um exemplo, consulte Sample registry key.

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

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

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

  • Esta versão inclui melhorias importantes no desempenho de processamento de regras: desempenho de processamento de regras 3x mais rápido!
    • A regra FindDownlevelFailure é até 10x 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 combinação de regra indica esse tipo de falha.
  • Foi removida a necessidade de especificar o parâmetro /Mode. Agora, se você especificar /LogsPath, ele assumirá 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 na Central de Download.

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

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

  • Correção de bugs para uma regra de plug-in super-matched. A regra agora corresponderá corretamente apenas a problemas críticos de plug-in (falha na instalação).
  • Novo recurso: capacidade de saída de 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 de regra para reparar o erro identificado. Por exemplo, instruções são fornecidas para resolver problemas conhecidos de bloqueio, como desinstalar um aplicativo incompatível ou liberar espaço na unidade do sistema.
  • 3 novas regras adicionadas: AdvancedInstallerFailed, MigrationAbortedDueToPluginFailure, DISMAddPackageFailed.

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

  • Corrigido um bug na detecção de falha de 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 as falhas de atualização que ocorrem antes de chamar SetupHost.
  • A telemetria é refatorada para enviar apenas o nome da regra e o GUID (ou "NoRuleMatched" se nenhuma regra for corresponder) e o Setup360 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 na Central de Download.

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

30/03/2018 - SetupDiag v1.00 é lançado com 26 regras, como uma ferramenta autônoma disponível na Central 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://docs.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://docs.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://docs.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:\/\/docs.microsoft.com\/en-us\/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.

Tópicos relacionados

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