Compartilhar via


Wilogutl.exe

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

Os erros não críticos não são exibidos. O Wilogutl.exe pode ser executado no modo silencioso ou com uma interface do usuário. A ferramenta gera relatórios como arquivos de texto nos modos silencioso e de interface do usuário. 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, confira Log.

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

Syntax

wilogutl.exe[<options>][<source file>][<options>][<report file directory>]

Use as linhas de comando a seguir para execução no modo silencioso.

wilogutl /q /lc:\mymsilog.log/oc\outputdir\

wilogutl /q /lc:\mymsilog.log

Opções de Linha de Comando

O Wilogutl.exe usa as opções de linha de comando a seguir sem diferenciação de maiúsculas e minúsculas. Um delimitador de traço pode ser usado no lugar de uma barra "/".

Opção Descrição
nenhum É executado no modo de interface do usuário, sem as opções de linha de comando.
/q Especifica o modo silencioso. O Wilogutl.exe gera arquivos de relatório e não exibe uma interface do usuário.
/l Especifica o nome do arquivo de log a ser analisado. Essa opção é obrigatória quando o modo silencioso é usado.
/o Especifica o diretório de saída para arquivos de relatório. Esse caminho de saída só é usado quando o modo silencioso é executado. Se a opção não estiver presente, os relatórios serão colocados no diretório C:\WiLogResults.

 

Quando executado no modo de interface do usuário, o Wilogutl.exe exibe as caixas de diálogo a seguir.

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 de arquivo de log e exibe a caixa de diálogo Exibição Detalhada do Arquivo de Log.
Exibição Detalhada do Arquivo de Log A caixa de diálogo Exibição Detalhada do Arquivo de Log exibe as informações de erro registradas em log. Use os botões Voltar e Avançar para navegar por vários erros. Para ver os 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 em log é exibida. Se a instalação registrada em log tiver sido executada com permissões elevadas, a caixa de seleção Instalação com privilégios elevados será selecionada e as informações serão fornecidas nas caixas de texto Detalhes do Privilégio do Lado do Cliente e Detalhes do Privilégio do Lado do Servidor. A caixa de diálogo Exibição Detalhada do Arquivo de Log contém os seguintes botões:
  • Estados – Mostra a caixa de diálogo Estados do Recurso e do Componente.
  • Propriedades – Mostra a caixa de diálogo Propriedades.
  • Políticas – Mostra a caixa de diálogo Políticas.
  • Log Anotado em HTML – Mostra o log como um arquivo anotado em HTML.
  • Salvar Resultados – Salva os arquivos de relatório no diretório especificado.
  • Ajuda da Mensagem de Erro – Mostra a ajuda da mensagem de erro do instalador.
  • Ajuda – Mostra a ajuda do 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 do Recurso e do Componente A caixa de diálogo Estados do Recurso e do Componente exibe os estados dos recursos e dos 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 do componente no final da instalação.
  • A coluna Solicitação mostra a seleção do usuário durante a instalação do estado do recurso ou do componente.
  • A coluna Ação mostra a ação executada pelo instalador para o recurso ou o componente.
Para obter mais informações, confira MsiGetComponentState e MsiGetFeatureState.
Propriedades A caixa de diálogo Propriedades mostra as Propriedades do Windows Installer e os respectivos valores no final da instalação. Você pode classificar as propriedades por nome ou por valor:
  • A guia Cliente mostra as propriedades e os valores durante a parte do cliente da instalação.
  • A guia Servidor mostra as propriedades e os valores durante a parte do servidor da instalação.
  • A guia Aninhado mostra as propriedades e os valores de todas as 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 igual a zero (0) definido para a política significa que a política não está habilitada.
  • Um valor igual a um (1) significa que a política está habilitada.
  • Um valor igual a ? (ponto de interrogação) significa que o valor da política não foi registrado no log.
Caso você precise de um valor de política que não esteja no log, tente usar o Regedit.exe para verificar as chaves do Registro no computador que estão causando a falha na instalação.

 

Arquivos de relatório

Quando você executa uma análise no modo silencioso ou clica no botão Salvar Resultados na caixa de diálogo Exibição Detalhada do Arquivo de Log, a ferramenta Analisador de Instalação do Windows Installer 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 nos 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 Exibiçã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. Esse arquivo lista os erros críticos e não críticos.
logfilename_policies.txt Identifica os nomes e os valores de política 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 a codificação de cores.

 

Valores de retorno

Se forem transmitidos argumentos de linha de comando inválidos para as operações no modo silencioso, o Wilogutl.exe não executará nenhuma ação e o processo retornará um dos valores da tabela a seguir.

Valor Significado
1 Um diretório de saída inválido foi especificado.
2 Um nome de arquivo de log inválido foi especificado.
3 /q foi transmitido, mas não tem a opção obrigatória /l para o nome do arquivo de log.
4 /l foi transmitido, mas não tem a opção obrigatória /q para o modo silencioso.

 

Versões, ferramentas e redistribuíveis liberados

Ferramentas de desenvolvimento do Windows Installer