Compartilhar via


Wilogutl.exe

Wilogutl.exe auxilia na análise de arquivos de log de uma instalação do Windows Installer e exibe soluções sugeridas para erros encontrados em um arquivo de log.

Erros não críticos não são exibidos. Wilogutl.exe pode ser executado no modo silencioso ou com uma interface de usuário (IU). A ferramenta gera relatórios como arquivos de texto na interface do usuário e no modo silencioso. Ela funciona melhor com arquivos de log detalhados do Windows Installer, mas também funciona com logs não detalhados. Para obter mais informações, veja Registro em log.

Esta ferramenta só está disponível nos Componentes do Windows SDK para desenvolvedores do Windows Installer.

Sintaxe

wilogutl.exe [<opções>][<arquivo de origem>][<opções>][<diretório do arquivo de relatório>]

Você pode usar as seguintes linhas de comando para executar no modo silencioso.

wilogutl /q /l c:\mymsilog.log /o c\outputdir\

wilogutl /q /l c:\mymsilog.log

Opções de Linha de Comando

Wilogutl.exe usa as seguintes opções de linha de comando que não diferenciam maiúsculas de minúsculas. Um delimitador de traço pode ser usado no lugar de uma barra.

Opção descrição
nenhum É executado no modo de IU, sem opções de linha de comando.
/q Especifica o modo silencioso. Wilogutl.exe gera arquivos de relatório e não exibe uma interface de usuário.
/l Especifica o nome do arquivo de log a ser analisado. Esta opção é necessária ao usar o modo silencioso.
/o Especifica o diretório de saída para arquivos de relatório. Este caminho de saída é usado somente durante a execução no modo silencioso. Caso a opção não esteja presente, os relatórios são colocados no diretório C:\WiLogResults.

 

Quando executado no modo de IU, Wilogutl.exe exibe as seguintes caixas de diálogo.

Nome Descrição
Analisador de log detalhado do Windows Installer A caixa de diálogo Analisador de log detalhado do Windows Installer permite que os usuários selecionem um arquivo de log para análise:
  • O botão Abrir abre o arquivo no Bloco de Notas. A área de visualização pode ser usada para verificar se o arquivo de log correto foi selecionado.
  • O botão Analisar inicia a análise do arquivo de log e exibe a caixa de diálogo Visualização detalhada do arquivo de log.
Visualização detalhada do arquivo de log A caixa de diálogo Visualização detalhada do arquivo de log exibe informações de erro registradas. Use os botões Voltar e Avançar para navegar por vários erros. Para exibir erros não críticos, marque a caixa de seleção Mostrar erros de depuração ignorados. A versão do instalador no computador usado para executar a instalação registrada é exibida. Se a instalação registrada foi executada com permissões elevadas, a caixa de seleção Instalação elevada será marcada e as informações serão fornecidas nas caixas de texto Detalhes de privilégio do lado do cliente e Detalhes de privilégio do lado do servidor. A caixa de diálogo Visualização detalhada do arquivo de log contém os seguintes botões:
  • Estados: mostra a caixa de diálogo Estados de recursos e componentes.
  • Propriedades : mostra a caixa de diálogo Propriedades.
  • Políticas: mostra a caixa de diálogo Políticas.
  • HTML Annotated Log: mostra o log como arquivo HTML anotado.
  • Salvar resultados: salva os arquivos de relatório no diretório especificado.
  • Ajuda com mensagens de erro: mostra ajuda com mensagens de erro do instalador.
  • Ajuda: mostra a ajuda para o Analisador de Log de Instalação do Windows Installer.
  • Como ler um arquivo de log: mostra o documento de ajuda do arquivo de log.
Estados de recursos e componentes A caixa de diálogo Estados de recursos e componentes exibe os estados dos recursos e componentes:
  • A coluna Recurso mostra o nome do recurso no pacote de instalação.
  • A coluna Componente mostra o nome do componente no pacote de instalação.
  • A coluna Instalado mostra o estado do recurso ou componente no final da instalação.
  • A coluna Solicitação mostra a seleção do usuário durante a instalação para o estado do recurso ou componente.
  • A coluna Ação mostra a ação executada pelo instalador para o recurso ou componente.
Para obter mais informações, consulte MsiGetComponentState e MsiGetFeatureState.
Propriedades A caixa de diálogo Propriedades mostra as Propriedades do Windows Installer e seus valores no final da instalação. Você pode classificar as propriedades por nome ou por valor:
  • A guia Cliente mostra propriedades e valores durante a parte da instalação do lado do cliente.
  • A guia Servidor mostra propriedades e valores durante a parte do servidor da instalação.
  • A guia Aninhado mostra as propriedades e os valores de quaisquer Instalações simultâneas.
Políticas A caixa de diálogo Políticas exibe a Política do Sistema definida após a instalação:
  • Um valor 0 (zero) definido para a política significa que a política não está habilitada.
  • Um valor 1 (um) significa que a política está habilitada.
  • Um valor de ? (ponto de interrogação) significa que o valor da política não está registrado no log.
Se você precisar de um valor de política que não esteja no log, tente usar Regedit.exe para verificar as chaves de registro no computador que falhou na instalação.

 

Arquivos de relatório

Ao executar uma análise no modo silencioso ou clicar no botão Salvar resultados na caixa de diálogo Visualização detalhada do arquivo de log, a ferramenta Windows Installer Setup Analyzer gera três arquivos de texto e um arquivo de log anotado em HTML.

A tabela a seguir identifica os nomes e o conteúdo dos arquivos de relatório.

Nome Descrição
logfilename_summary.txt Resume o arquivo de log. Lista as informações exibidas pela caixa de diálogo Visualização detalhada do arquivo de log e o primeiro erro.
logfilename_errors.txt Identifica o número de erros, os erros e as soluções recomendadas. Este arquivo lista erros críticos e não críticos.
logfilename_policies.txt Identifica os nomes e valores das políticas definidos no final da instalação, como na caixa de diálogo Políticas.
details_logfilename.htm Um log anotado em HTML com uma legenda para o código de cores.

 

Valores retornados

Se argumentos de linha de comando inválidos forem passados ​​para operações em modo silencioso, Wilogutl.exe não fará nada e o processo retornará um dos valores na tabela a seguir.

Valor Significado
1 O diretório de saída inválido foi especificado.
2 Foi especificado um nome de arquivo de log inválido.
3 /q aprovado, mas falta a opção necessária /l para o nome do arquivo de log.
4 /l aprovado, mas falta a opção necessária /q para o modo silencioso.

 

Versões lançadas, ferramentas e redistribuíveis

Ferramentas de desenvolvimento do Windows Installer