Compartilhar via

SetupDiag

Observação

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

Acerca do SetupDiag

Importante

Quando o SetupDiag é executado manualmente, a Microsoft recomenda a execução da versão mais recente do SetupDiag. A versão mais recente está disponível através da seguinte ligação:

Transferir a versão mais recente do SetupDiag

Executar a versão mais recente garante a funcionalidade mais recente e corrige problemas conhecidos.

O SetupDiag é uma ferramenta de diagnóstico que pode ser utilizada para obter detalhes sobre o motivo pelo qual uma atualização do Windows não teve êxito.

O SetupDiag funciona ao examinar os ficheiros de registo da Configuração do Windows. Tenta analisar estes ficheiros de registo para determinar a causa raiz de uma falha ao atualizar ou atualizar o computador para o Windows. O SetupDiag pode ser executado no computador que não conseguiu atualizar. Os registos também podem ser exportados do computador para outra localização e, em seguida, executar o SetupDiag no modo offline.

O SetupDiag está incluído na Configuração do Windows em todas as versões atualmente suportadas do Windows.

Durante o processo de atualização, a Configuração do Windows extrai todos os respetivos ficheiros de origem, incluindo SetupDiag.exe, para o %SystemDrive%\$Windows.~bt\Sources diretório . Se existir um problema com a atualização, o SetupDiag é executado automaticamente para determinar a causa da falha.

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

  • /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 em %WinDir%\Logs\SetupDiag\SetupDiagResults.xml e no registo HKLM\SYSTEM\Setup\SetupDiag\Resultsem .

Observação

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

Importante

Quando SetupDiag indica que ocorreram várias falhas, a última falha no ficheiro de registo é normalmente o erro fatal e não o primeiro.

Se o processo de atualização continuar normalmente, o Sources diretório incluindo SetupDiag.exe é movido para limpeza %SystemDrive%\Windows.Old . Se o Windows.old diretório for eliminado mais tarde, SetupDiag.exe também será removido.

Dica

Se SetupDiag.exe for necessário depois de o Windows.old diretório ser eliminado, pode ser transferido a partir do Centro de Transferências da Microsoft.

Requisitos

  1. A versão de destino do Windows tem de ser uma versão atualmente suportada do Windows. A versão originalmente instalada do Windows pode ser uma versão do Windows sem suporte desde que:

    • A versão de destino do Windows é uma versão suportada atualmente do Windows.
    • A atualização para a versão de destino do Windows é suportada a partir da versão original instalada do Windows.

  2. .NET Framework 4.7.2 ou mais recente tem de estar instalado. Para determinar que versão do .NET está pré-instalada com uma versão específica do Windows, veja requisitos de sistema .NET Framework: Sistemas operativos cliente suportados. Para determinar que versão do .NET está atualmente instalada, veja Como: Determinar Que Versões .NET Framework Estão Instaladas.

    A seguinte consulta da linha de comandos pode ser utilizada para apresentar 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 esteja instalada, não é necessária nenhuma ação adicional, incluindo se estiver instalada uma versão mais recente.

  3. Setupdiag.exe deve ser executada a partir de uma linha de comandos elevada para que funcione corretamente.

Utilizar o SetupDiag

Para utilizar o SetupDiag:

  1. Verifique se o sistema cumpre os requisitos.

  2. Transfira a versão mais recente do SetupDiag.

  3. Se o browser perguntar o que fazer com o ficheiro, selecione Guardar. Por predefinição, o ficheiro é guardado na pasta Transferências, que é apresentada no Explorador de Arquivos em Acesso rápido no painel de navegação esquerdo. Se pretender, o ficheiro também pode ser guardado numa localização diferente através da opção Guardar Como.

  4. Assim que o SetupDiag concluir a transferência, abra uma linha de comandos elevada e navegue para o diretório para o qual setupdiag.exe foi transferido e guardado.

  5. Na linha de comandos elevada, execute setupdiage.exe no modo online com os parâmetros pretendidos, conforme documentado nas secções Parâmetros e Exemplos .

  6. Aguarde até que o SetupDiag termine.

  7. Quando o SetupDiag terminar, são criados dois ficheiros na mesma pasta a partir da qual o SetupDiag foi executado:

    • Um ficheiro de configuração.
    • Um ficheiro de registo.

  8. Utilize o Bloco de Notas para abrir o ficheiro de registo SetupDiagResults.log.

  9. Reveja as informações apresentadas. Se uma regra tiver sido correspondida, estas informações podem indicar o motivo pelo qual o computador não conseguiu atualizar e, potencialmente, como corrigir o problema. Veja a secção Exemplo de registo de texto.

Dica

Para obter instruções sobre como executar a ferramenta no modo offline no Windows PE, consulte as secções Parâmetros e Exemplos.

Parâmetros

Parâmetro Descrição
/? Apresenta informações de ajuda
/Output:[Caminho completo e nome de ficheiro para o ficheiro de registo de saída] Este parâmetro opcional especifica o nome e a localização do ficheiro de registo de resultados. O ficheiro de saída contém a análise de SetupDiag. Só é suportada a saída do formato de texto. Os caminhos UNC funcionam desde que o contexto em que o SetupDiag é executado tenha acesso ao caminho UNC. Se o caminho tiver um espaço, todo o caminho tem de estar entre aspas ("). Veja as secções Exemplos para obter um exemplo.

Predefinição: se não for especificado, SetupDiag cria o ficheiro SetupDiagResults.log no mesmo diretório onde SetupDiag.exe é executado.
/LogsPath:[Caminho completo para registos] Este parâmetro opcional especifica a localização dos registos a analisar e onde encontrar os ficheiros de registo para uma análise offline. Estes ficheiros de registo podem estar num formato de pasta simples ou conter vários subdiretórios. O SetupDiag procura recursivamente todos os diretórios subordinados. A predefinição é verificar a existência de registos no sistema atual.
/ZipLogs:[Verdadeiro | Falso] Este parâmetro opcional Indica SetupDiag.exe para criar um ficheiro zip que contém os resultados e todos os ficheiros de registo que foram analisados. O ficheiro zip é criado no mesmo diretório onde SetupDiag.exe é executado.

Predefinição: se não for especificado, é utilizado um valor de "verdadeiro".
/Format:[xml | json] Este parâmetro opcional especifica o formato de saída para os ficheiros de registo serem XML ou JSON. Se este parâmetro não for especificado, o formato de texto é utilizado por predefinição.
/Scenario:[Recovery | Depuração] Este parâmetro opcional pode efetuar um dos seguintes dois itens com base no argumento utilizado:

  • A recuperação instrui SetupDiag.exe a procurar e processar registos de reposição e recuperação e ignorar os registos de configuração/atualização.
  • A depuração instrui SetupDiag.exe a depurar capturas de memória se os binários de depuração necessários estiverem instalados.
/Verboso Este parâmetro opcional cria um registo de diagnóstico no diretório atual, com informações de depuração, dados adicionais e detalhes sobre o SetupDiag. Por predefinição, o SetupDiag só produz uma entrada de ficheiro de registo para erros principais. A utilização de /Verbose faz com que o SetupDiag produza sempre outro ficheiro de registo com detalhes de depuração. Estes detalhes podem ser úteis ao comunicar um problema com o SetupDiag.
/NoTel Este parâmetro opcional indica SetupDiag.exe não enviar telemetria de diagnóstico à Microsoft.
/RegPath Este parâmetro opcional Indica SetupDiag.exe para adicionar informações de falha ao registo no caminho especificado. Os caminhos de registo devem começar com HKEY_LOCAL_MACHINE ou HKEY_CURRENT_USER e estar acessíveis ao nível da elevação em Que o SetupDiag é executado. Se este parâmetro não for especificado, o caminho predefinido é HKLM\SYSTEM\Setup\MoSetup\Volatile\SetupDiag.
/AddReg Este parâmetro opcional Indica SetupDiag.exe para adicionar informações de falha ao registo no sistema de execução no modo offline. Por predefinição, o SetupDiag adiciona informações de falha ao registo apenas no modo Online. Os dados de registo são enviados para HKEY_LOCAL_MACHINE\SYSTEM\Setup\MoSetup\Volatile\SetupDiag , salvo especificação em contrário.

Observação

O parâmetro /Mode foi preterido em SetupDiag.

Em versões anteriores, o parâmetro /Mode foi utilizado com o parâmetro /LogsPath no modo offline e analisaria um conjunto de ficheiros de registo que foram capturados num computador diferente. Nas versões atuais do SetupDiag, quando o /LogsPath é especificado, o SetupDiag é executado automaticamente no modo offline, pelo que o parâmetro /Mode não é necessário.

Exemplos

Importante

SetupDiage.exe deve ser executada a partir de uma linha de comandos elevada para que funcione corretamente.

  • No exemplo seguinte, SetupDiag é executado sem parâmetros e apresenta informações de ajuda.

    SetupDiag.exe

  • No exemplo seguinte, SetupDiag é executado no modo online (este modo é a predefinição). Sabe onde procurar registos no sistema atual (com falhas), pelo que não é necessário recolher registos antecipadamente. É especificada uma localização personalizada para os resultados.

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

  • O exemplo seguinte utiliza o parâmetro /Output para guardar resultados num nome de caminho que contém um espaço:

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

  • O exemplo seguinte especifica que SetupDiag é executar no modo offline e processar os ficheiros de registo encontrados em D:\Temp\Logs\LogSet1.

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

  • Segue-se um exemplo de Modo Offline de Reposição/Recuperação. SetupDiag é instruído a procurar registos de reposição/recuperação na localização do LogsPath especificada. Em seguida, produz 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 seguinte é um exemplo de Modo Online de Reposição/Recuperação. O SetupDiag é instruído a procurar registos de reposição/recuperação no sistema atual e a exportar os resultados no formato XML.

    SetupDiag.exe /Scenario:Recovery /Format:xml

  • O exemplo seguinte é um exemplo do Modo Offline. O SetupDiag é instruído a analisar ficheiros de registo de configuração/atualização no diretório LogsPath e a exportar 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 seguinte é um exemplo do Modo Online. O SetupDiag é instruído a procurar registos de configuração/atualização no sistema atual e a exportar os resultados no formato XML para C:\SetupDiag\Results.xml.

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

Arquivos de log

Os Ficheiros de Registo e os Registos de Eventos da Configuração do Windows têm informações sobre onde os registos são criados durante a Configuração do Windows. Para processamento offline, o SetupDiag deve ser executado no conteúdo de toda a pasta. Por exemplo, dependendo de quando a atualização falhou, copie uma das seguintes pastas para a localização offline:

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

Se a pasta principal e todas as subpastas forem copiadas, o SetupDiag procura automaticamente ficheiros de registo em todos os subdiretórios.

Configurar a análise de marcar de erros

Quando o Microsoft Windows encontra uma condição que compromete o funcionamento seguro do sistema, o sistema é interrompido. Esta condição é denominada marcar de erros. Esta condição também é frequentemente referida como uma falha do sistema, um erro de kernel, um erro fatal ou BSOD. Normalmente, um dispositivo de hardware, controlador de hardware ou software relacionado causa este erro.

Se as informações de falha de sistema estiverem ativadas no sistema, é criado um ficheiro de informação de falha de sistema. Se o erro marcar ocorrer durante uma atualização, a Configuração do Windows extrai um ficheiro minidump (setupmem.dmp). O SetupDiag também pode depurar estes minidumps relacionados com a configuração.

Para depurar um erro relacionado com a configuração marcar:

  • Especifique o parâmetro /LogsPath . As capturas de memória não podem ser depuradas no modo online.

  • Recolha o ficheiro de captura de memória de configuração ('setupmem.dmp) do sistema com falhas.

    Setupmem.dmpé criado em %SystemDrive%$Windows.~bt\Sources\Rollback ou em %WinDir%\Panther\NewOS\Rollback, dependendo de quando ocorre o erro marcar.

  • Instale as Ferramentas de Depuração do Windows no computador que executa o SetupDiag.

No exemplo seguinte, o setupmem.dmp ficheiro é 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 demorar muito tempo a processar se os ficheiros de registo envolvidos forem grandes.

Saída de exemplo

O comando seguinte é 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 o SetupDiag procura ficheiros de registo, utiliza um conjunto de regras para corresponder a problemas conhecidos. Estas regras estão contidas num ficheiro xml. O ficheiro xml pode ser atualizado com regras novas e atualizadas à medida que são disponibilizadas novas versões do SetupDiag.

Cada nome de regra e o respetivo identificador de regra exclusivo associado são listados com uma descrição do problema conhecido de bloqueio de atualização. Nas descrições das regras, o termo nível inferior refere-se à primeira fase do processo de atualização, que é executada no SO original.

Nome da Regra GUID Descrição
CompatScanOnly FFDAFD37-DB75-498A-A893-472D49A1311D Esta regra indica que setup.exe foi chamada com um parâmetro de linha de comandos específico que indicava que a configuração era apenas para fazer uma análise de compatibilidade e não uma atualização.
PlugInComplianceBlock D912150B-1302-4860-91B5-527907D08960 Deteta todos os blocos de compatibilidade dos plug-ins de conformidade do Servidor. Esta regra destina-se apenas a atualizações do servidor. Produz o bloco de conformidade e a remediação necessárias.
BitLockerHardblock C30152E2-938E-44B8-915B-D1181BA635AE Este bloco é um bloco de atualização quando o SO de destino não suporta o BitLocker, mas o SO anfitrião tem o BitLocker ativado.
VHDHardblock D9ED1B82-4ED8-4DFD-8EC0-BE69048978CC Este bloco ocorre quando o SO anfitrião é arrancado para uma imagem VHD. A atualização não é suportada quando o SO anfitrião é arrancado a partir de uma imagem VHD.
PortableWorkspaceHardblock 5B0D3AB4-212A-4CE4-BDB9-37CA404BB280 Este bloco indica que o SO anfitrião é arrancado a partir de um dispositivo Windows To-Go (tecla USB). A atualização não é suportada no ambiente do Windows To-Go.
AuditModeHardblock A03BD71B-487B-4ACA-83A0-735B0F3F1A90 Este bloco indica que o SO anfitrião é atualmente arrancado no Modo de Auditoria, um modo especial para modificar o estado do Windows. A atualização não é suportada a partir deste estado.
SafeModeHardblock 404D9523-B7A8-4203-90AF-5FBB05B6579B Este bloco indica que o SO anfitrião é arrancado para o Modo de Segurança, onde a atualização não é suportada.
InsufficientSystemPartitionDiskSpaceHardblock 3789FBF8-E177-437D-B1E3-D38B4C4269D1 Este bloco é encontrado quando a configuração determina que a partição do sistema não tem espaço suficiente para ser reparado com os ficheiros de arranque mais recentes necessários durante o processo de atualização. A partição do sistema é onde os ficheiros do carregador de arranque são armazenados
CompatBlockedApplicationAutoUninstall BEBA5BC6-6150-413E-8ACE-5E1EC8D34DD5 Esta regra indica que há uma aplicação que precisa de ser desinstalada antes de a configuração poder continuar.
CompatBlockedApplicationDismissable EA52620B-E6A0-4BBC-882E-0686605736D9 Quando a configuração é executada no modo /quiet , existem mensagens de aplicação dispensáveis que se transformam em blocos, a menos que a linha de comandos também especifique /compat ignorewarning. Esta regra indica que a configuração foi executada no modo /quiet , mas existe uma mensagem de bloqueio dispensável da aplicação que impediu a configuração de continuar.
CompatBlockedFODDismissable 7B693C42-793E-4E9E-A10B-ED0F33D45E2A Quando a configuração é executada no modo /quiet , existem mensagens de Funcionalidade a Pedido dispensáveis que se transformam em blocos, a menos que a linha de comandos também especifique /compat ignorewarning. Esta regra indica que a configuração foi executada no modo /quiet , mas existe uma mensagem de bloqueio dispensável de Funcionalidade a Pedido que impediu a configuração de continuar, normalmente, que a imagem do SO de destino não tem uma Funcionalidade a Pedido instalada no SO atual. A remoção da Funcionalidade a Pedido no SO atual também deve resolve o problema.
CompatBlockedApplicationManualUninstall 9E912E5F-25A5-4FC0-BEC1-CA0EA5432FF4 Esta regra indica que uma aplicação sem uma entrada Adicionar/Remover Programas está presente no sistema e impede que a configuração continue. Normalmente, este bloco requer a remoção manual dos ficheiros associados a esta aplicação para continuar.
GenericCompatBlock 511B9D95-C945-4F9B-BD63-98F1465E1CF6 A regra indica que o sistema não cumpre um requisito de hardware para executar o Windows. Por exemplo, o dispositivo não tem um requisito para o TPM 2.0. Este problema pode ocorrer mesmo quando é efetuada uma tentativa de ignorar os requisitos de hardware.
GatedCompatBlock 34A9F145-3842-4A68-987F-4622EE0FC162 Esta regra indica que a atualização falhou devido a um bloqueio temporário. É implementado um bloco temporário quando é encontrado um problema com uma parte específica do software ou controlador de hardware e o problema tem uma correção pendente. O bloco é levantado assim que a correção estiver amplamente disponível.
HardblockDeviceOrDriver ED3AEFA1-F3E2-4F33-8A21-184ADF215B1B Este erro indica que um controlador de dispositivo carregado no SO anfitrião não é compatível com a versão mais recente do SO. O controlador de dispositivo tem de ser removido antes da atualização.
HardblockMismatchedLanguage 60BA8449-CF23-4D92-A108-D6FCEFB95B45 Esta regra indica que o SO anfitrião e as edições de idioma do SO de destino não correspondem.
HardblockFlightSigning 598F2802-3E7F-4697-BD18-7A6371C8B2F8 Esta regra indica que o SO de destino é uma pré-versão, compilação do Windows Insider e o computador de destino tem o Arranque Seguro ativado. Esta regra bloqueia o arranque da compilação assinada de pré-lançamento se estiver instalada no computador.
DiskSpaceBlockInDownLevel 6080AFAC-892E-4903-94EA-7A17E69E549E Esta falha indica que o sistema ficou sem espaço em disco durante as operações de nível inferior da atualização.
DiskSpaceFailure 981DCBA5-B8D0-4BA7-A8AB-4030F7A10191 Esta falha indica que a unidade do sistema ficou sem espaço disponível em disco em algum momento após o primeiro reinício para a atualização.
PreReleaseWimMountDriverFound 31EC76CC-27EC-4ADC-9869-66AABEDB56F0 Captura falhas devido a um controlador não reconhecido wimmount.sys registado no sistema.
DebugSetupMemoryDump C7C63D8A-C5F6-4255-8031-74597773C3C6 Esta regra apenas offline indica que ocorreu um erro marcar ocorrido durante a configuração. Se as ferramentas de depurador estiverem disponíveis no sistema, o SetupDiag depura a captura de memória e fornece detalhes.
DebugSetupCrash CEEBA202-6F04-4BC3-84B8-7B99AED924B1 Esta regra apenas offline indica que a própria configuração encontrou uma falha que resultou numa captura de memória do processo. Se as ferramentas de depurador estiverem instaladas no sistema, o SetupDiag depura a captura de memória e fornece mais detalhes.
DebugMemoryDump 505ED489-329A-43F5-B467-FCAAF6A1264C Esta regra apenas offline destina-se a qualquer ficheiro memory.dmp que resultou durante a operação de configuração/atualização. Se as ferramentas de depurador estiverem instaladas no sistema, o SetupDiag depura a captura de memória e fornece mais detalhes.
DeviceInstallHang 37BB1C3A-4D79-40E8-A556-FDA126D40BC6 Esta regra de falha indica o sistema bloqueado ou o erro verificado durante a fase de instalação do dispositivo da atualização.
DriverPackageMissingFileFailure 37BB1C3A-4D79-40E8-A556-FDA126D40BC6 Esta regra indica que um pacote de controlador tinha um ficheiro em falta durante a instalação do dispositivo. Atualizar o pacote de controladores pode ajudar a resolve o problema.
UnsignedDriverBootFailure CD270AA4-C044-4A22-886A-F34EF2E79469 Esta regra indica que um controlador não assinado causou uma falha de arranque.
BootFailureDetected 4FB446C2-D4EC-40B4-97E2-67EB19D1CFB7 Esta regra indica que ocorreu uma falha de arranque durante uma fase específica da atualização. A regra indica o código e a fase da falha para fins de diagnóstico.
WinSetupBootFilterFailure C073BFC8-5810-4E19-B53B-4280B79E096C Deteta falhas nas operações de ficheiros do modo kernel.
FindDebugInfoFromRollbackLog 9600EB68-1120-4A87-9FE9-3A4A70ACFC37 Esta regra determina e fornece detalhes quando ocorre um erro marcar durante o processo de configuração/atualização que resultou numa captura de memória. No entanto, não é necessário um pacote de depurador no computador em execução.
AdvancedInstallerFailed 77D36C96-32BE-42A2-BB9C-AAFFE64FCADC Localiza operações do instalador avançadas fatais que causam falhas de configuração. Indica uma falha crítica no AdvancedInstaller durante a execução de um pacote de instalação, inclui o .exe que está a ser chamado, a fase, o modo, o componente e os códigos de erro.
AdvancedInstallerPluginInstallFailed 2F784A0E-CEB1-47C5-8072-F1294C7CB4AE Esta regra indica que alguns componentes que estavam a ser instalados através de um instalador avançado (FeatureOnDemand, Language Packs, pacotes .NET, etc.) não foram instalados. A regra chama a atenção para o que estava a ser instalado. Se o componente com falha for uma FuncionalidadeOnDemand, remova a Funcionalidade do Windows, reinicie e tente atualizar novamente. Se o componente com falha for um Pacote de Idiomas, remova o pacote de idiomas adicional, reinicie e tente atualizar novamente.
AdvancedInstallerGenericFailure 4019550D-4CAA-45B0-A222-349C48E86F71 Uma regra para corresponder a falhas de leitura/escrita do AdvancedInstaller num sentido genérico. Acionadores em falhas avançadas do instalador num sentido genérico. Produz a aplicação denominada, fase, modo, componente e código de erro.
FindMigApplyUnitFailure A4232E11-4043-4A37-9BF4-5901C46FD781 Deteta uma falha na unidade de migração que causou a falha da atualização. Esta regra produz o nome do plug-in de migração e o código de erro que produziu para fins de diagnóstico.
FindMigGatherUnitFailure D04C064B-CD77-4E64-96D6-D26F30B4EE29 Deteta uma falha de unidade de recolha de migração que causou a falha da atualização. Esta regra produz o nome da unidade de recolha/plug-in e o código de erro que produziu para fins de diagnóstico.
FindMigGatherApplyFailure A9964E6C-A2A8-45FF-B6B5-25E0BD71428E Mostra erros quando o Motor de migração falha numa operação de recolha ou aplicação. Indica o Objeto de Migração (caminho do ficheiro ou do registo), a Migração
OptionalComponentFailedToGetOCsFromPackage D012E2A2-99D8-4A8C-BBB2-088B92083D78 Esta regra corresponde a uma falha específica do Componente Opcional ao tentar enumerar componentes num pacote. Indica que a operação de migração do componente opcional (OC) não conseguiu enumerar componentes opcionais de um Pacote OC. Produz o nome do pacote e o código de erro. Esta regra substitui a regra OptionalComponentInstallFailure presente.
OptionalComponentOpenPackageFailed 22952520-EC89-4FBD-94E0-B67DF88347F6 Corresponde a uma falha específica do Componente Opcional ao tentar abrir um pacote OC. Produz o nome do pacote e o código de erro. Indica que a operação opcional de migração de componentes não conseguiu abrir um Pacote de componente opcional. Produz o nome do pacote e o código de erro.
OptionalComponentInitCBSSessionFailed 63340812-9252-45F3-A0F2-B2A4CA5E9317 Corresponde a uma falha específica em que o serviço ou componentes do instalador avançado não estão a funcionar ou iniciados no sistema. Indica danos na pilha de manutenção no sistema de nível inferior. Produz o código de erro encontrado ao tentar inicializar o componente de manutenção no SO existente.
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. Indica a fase e o código de erro que ocorreram ao tentar atualizar a imagem do SafeOS para fins de diagnóstico.
UserProfileCreationFailureDuringOnlineApply 678117CE-F6A9-40C5-BC9F-A22575C78B14 Indica que ocorreu uma falha crítica ao criar ou modificar um Perfil de Utilizador durante a fase de aplicação online da atualização. 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 Utilizador durante a fase de finalização da configuração. Produz o código de falha.
UserProfileSuffixMismatch B4BBCCCE-F99D-43EB-9090-078213397FD8 Deteta quando um ficheiro ou outro objeto faz com que a migração ou criação de um perfil de utilizador falhe durante a atualização.
DuplicateUserProfileFailure BD7B3109-80F1-4421-8F0A-B34CD25F4B51 Esta regra indica um erro fatal ao migrar perfis de utilizador, normalmente com vários SIDs associados a um único perfil de utilizador. Normalmente, este erro ocorre quando o software cria contas de utilizador locais que nunca são utilizadas ou com sessão iniciada. A regra indica o SID e o Nome de Utilizador da conta que está a causar a falha. Para tentar resolve o problema, crie primeiro uma cópia de segurança de todos os ficheiros do utilizador para a conta de utilizador afetada. Após a cópia de segurança dos ficheiros do utilizador, elimine a conta de forma suportada. Certifique-se de que a conta não é necessária ou que está atualmente a ser utilizada para iniciar sessão no dispositivo. Depois de eliminar a conta, reinicie e tente atualizar novamente.
WimMountFailure BE6DF2F1-19A6-48C6-AEF8-D3B0CE3D4549 Esta regra indica que a atualização não conseguiu montar um ficheiro WIM. Mostra o nome do ficheiro 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 Deteta falhas no WimMount.sys registo no sistema.
WimApplyExtractFailure 746879E9-C9C5-488C-8D4B-0C811FF3A9A8 Corresponde a uma falha de aplicação wim durante as fases de extração de WIM da configuração. Produz a extensão, o caminho e o código de erro.
UpdateAgentExpanderFailure 66E496B3-7D19-47FA-B19B-4040B9FD17E2 Corresponde a falhas do expansor DPX na fase de nível inferior da atualização do Windows Update. Produz 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 decida ser fatal para a configuração. Produz 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 num plug-in de migração que faz com que a configuração aborte a migração. Fornece a operação de configuração, o nome do plug-in, a ação de plug-in e o código de erro.
DISMAddPackageFailed 6196FF5B-E69E-4117-9EC6-9C1EAB20A3B9 Indica uma falha crítica durante uma operação de adição de pacote DISM. Especifica o Nome do Pacote, o erro DISM e o código de erro adicionar 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 Aciona quando um fornecedor DISM (plug-in) falha numa operação crítica. Produz o ficheiro (nome do plug-in), a função denominada + código de erro e a mensagem de erro do fornecedor.
SysPrepLaunchModuleFailure 7905655C-F295-45F7-8873-81D6F9149BFD Indica que um plug-in sysPrep falhou numa 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 controlador fornecido para a configuração (através da entrada da linha de comandos) falhou de alguma forma. Produz a função de instalação do controlador e o código de erro.
DriverMigrationFailure 9378D9E2-256E-448C-B02F-137F611F5CE3 Esta regra indica uma falha fatal ao migrar controladores.
UnknownDriverMigrationFailure D7541B80-5071-42CE-AD14-FBE8C0C4F7FD Esta regra indica que um pacote de controlador incorreto reside no sistema. O pacote de controladores faz com que a atualização falhe quando o pacote de controladores é tentado a migrar para o novo SO. Normalmente, a regra indica o nome do pacote de controlador que causou o problema. A remediação é remover o pacote de controlador incorreto, reiniciar e tentar a atualização novamente. Se estiver disponível uma atualização para este controlador a partir do OEM, recomenda-se atualizar o pacote de controladores.
FindSuccessfulUpgrade 8A0824C8-A56D-4C55-95A0-22751AB62F3E Determina se a configuração especificada foi um êxito ou não com base nos registos.
FindSetupHostReportedFailure 6253C04F-2E4E-4F7A-B88E-95A69702F7EC Fornece informações sobre falhas que surgiram no início do processo de atualização por setuphost.exe
FindDownlevelFailure 716334B7-F46A-4BAA-94F2-3E31BC9EFA55 Fornece informações sobre falhas apresentadas pelo SetupPlatform, mais à frente na fase de nível inferior.
FindAbruptDownlevelFailure 55882B1A-DA3E-408A-9076-23B22A0472BD Fornece informações de falha da última operação quando o sistema falha no nível inferior, mas o registo termina abruptamente.
FindEarlyDownlevelError A4CE4FC9-5E10-4BB1-8ECE-3B29EB9D7C52 Deteta falhas na fase de nível inferior antes de a plataforma de configuraçã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. Esta regra indica a operação e o erro associados à falha para fins de diagnóstico.
FindRollbackFailure 3A43C9B5-05B3-4F7C-A955-88F991BB5A48 Fornece a última operação, fase de falha e informações de erro quando ocorre uma reversão.

Registos de exemplo

Exemplo de registo 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 downlevel failure, Operation: Finalize, Error: 0x8007001F - 0x50015
Refer to https://learn.microsoft.com/windows/deployment/upgrade/upgrade-error-codes for error information.

Exemplo de registo 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 registo 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 registo de exemplo

Exemplo de Chave de registo addreg.

  • Last updated on