Útil para administradores, ela pode ser executada no computador onde a atualização/upgrade falhou ou em outro computador se os arquivos de log relevantes estiverem disponíveis (por exemplo, se eles tiverem sido copiados para estre outro PC).
Como usar a ferramenta SetupDiag no Windows 10
Antes de começar, certifique-se de que o computador tem o Windows 10 e o .NET Framework 4.6 ou posterior instalados.
Para usar a ferramenta SetupDiag no Windows 10, primeiro faça o download dela clicando neste link.
Agora clique no arquivo SetupDiag.exe para executá-lo no modo padrão (ou modo online). A janela do prompt de comando será exibida e fechada automaticamente quando a análise for concluída:
Ele criará os arquivos SetupDiag.exe.config, SetupDiagResults.log e Logs.zip na mesma pasta:
Outros exemplos de comandos que podem ser usados com a ferramenta podem ser vistos abaixo:
No exemplo a seguir, SetupDiag é executado no modo online. Ele saberá onde procurar os registros no sistema atual (com falha), portanto, não é preciso coletar os logs com antecedência do tempo. 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 deve 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, o SetupDiag pesquisará os logs de restauração/recuperação no local LogsPath especificado e produzirá o resuts 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, o SetupDiag pesquisará os logs de restauração/recuperação nos resultados do sistema atual e da saída no formato XML:
SetupDiag.exe /Scenario:Recovery /Format:xml
A ferramenta usa 60 regras para detectar os problemas e 10 delas podem ser vistas abaixo:
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 indicou que a instalação era fazer apenas uma verificação de compatibilidade, e não uma atualização.
BitLockerHardblock – C30152E2-938E-44B8-915B-D1181BA635AE
Isso é um bloco quando o sistema operacional de destino não é compatível com o BitLocker, mas o sistema operacional do host tem o BitLocker habilitado.
VHDHardblock – D9ED1B82-4ED8-4DFD-8EC0-BE69048978CC
Esse bloco acontece quando o sistema operacional host é inicializado em uma imagem VHD. Não há suporte para a atualização quando o sistema operacional host é inicializado a partir de uma imagem VHD.
PortableWorkspaceHardblock – 5B0D3AB4-212A-4CE4-BDB9-37CA404BB280
Isso indica que o sistema operacional host é inicializado a partir de um dispositivo Windows to-go (chave USB). Não há suporte para a atualização no ambiente Windows to-go.
AuditModeHardblock – A03BD71B-487B-4ACA-83A0-735B0F3F1A90
Esse bloco indica que o sistema operacional host está inicializado no modo de auditoria, um modo especial para modificar o estado do Windows. Não há suporte para a atualização deste estado.
SafeModeHardblock – 404D9523-B7A8-4203-90AF-5FBB05B6579B
Esse bloco indica que o sistema operacional host é inicializado no modo de segurança, em que não há suporte para a atualização.
InsufficientSystemPartitionDiskSpaceHardblock – 3789FBF8-E177-437D-B1E3-D38B4C4269D1
Esse bloco é encontrado quando o programa de instalação determina a partição do sistema (em que os arquivos do carregador de inicialização são armazenados) não tem espaço suficiente para atender aos arquivos de inicialização mais recentes necessários durante o processo de atualização.
CompatBlockedApplicationAutoUninstall – BEBA5BC6-6150-413E-8ACE-5E1EC8D34DD5
Essa regra indica que há um aplicativo que precisa ser desinstalado antes que a instalação possa continuar.
CompatBlockedApplicationDismissable – EA52620B-E6A0-4BBC-882E-0686605736D9
Ao executar a instalação no modo/Quiet, há dismiss mensagens de aplicativo que se transformam em blocos, a menos que a linha de comando também especifique “aviso de/ignore de/compat”. Esta regra indica que a instalação foi executada no modo/Quiet, mas há uma mensagem de bloqueio do aplicativo dismiss que impedia a continuação da instalação.
CompatBlockedApplicationManualUninstall – 9E912E5F-25A5-4FC0-BEC1-CA0EA5432FF4
Essa regra indica que um aplicativo sem uma entrada de adicionar/remover programas está presente no sistema e impedir que a instalação continue. Geralmente, isso exige a remoção manual dos arquivos associados a este aplicativo para continuar.