Installutil.exe (Ferramenta de Instalação)

  • Artigo

A ferramenta Instalador é um utilitário de linha de comando que permite instalar e desinstalar recursos de servidor executando-se os componentes do instalador em assemblies especificados. Essa ferramenta funciona com classes no namespace System.Configuration.Install.

Essa ferramenta é instalada automaticamente com o Visual Studio. Para executar a ferramenta, use o Prompt de Comando do Desenvolvedor do Visual Studio ou o PowerShell do Desenvolvedor do Visual Studio.

No prompt de comando, digite o seguinte:

Sintaxe

installutil [/u[ninstall]] [options] assembly [[options] assembly] ...

Parâmetros

Argumento Descrição
assembly O nome do arquivo do assembly no qual os componentes do instalador devem ser executados. Omita esse parâmetro se você quiser especificar o nome forte do assembly usando a opção /AssemblyName.

Opções

Opção Descrição
/h[elp]

- ou -

/?		 Exibe sintaxe de comando e opções para a ferramenta.
/helpassembly

-ou-

/?assembly		 Exibe opções adicionais reconhecidas por instaladores individuais dentro do assembly especificado, com a sintaxe do comando e as opções de InstallUtil.exe. Essa opção adiciona o texto retornado pela propriedade Installer.HelpText de cada componente do instalador para o texto de ajuda de InstallUtil.exe. Por exemplo, se ServiceProcessInstaller.Account estiverUser, as opções e /username as /password estarão disponíveis.
/AssemblyName "assemblyName

,Version=major.minor.build.revision

,Culture=locale

,PublicKeyToken=publicKeyToken"		 Especifica o nome forte de um assembly, que deve ser registrado no cache de assembly global. O nome do assembly deve ser totalmente qualificado com a versão, a cultura e o token de chave pública do assembly. O nome totalmente qualificado deve estar entre aspas.

Por exemplo, "myAssembly, Culture=neutral, PublicKeyToken=0038abc9deabfle5, Version=4.0.0.0" é um nome de assembly totalmente qualificado.
/InstallStateDir=[directoryName] Especifica o diretório do arquivo .InstallState que contém os dados usados para desinstalar o assembly. O padrão é o diretório que contém o assembly.
/LogFile=[filename] Especifica o nome do arquivo de log em que o andamento da instalação é registrado. Por padrão, se a opção /LogFile for omitida, um arquivo de log chamado assemblyname.InstallLog será criado. Se filename for omitido, nenhum arquivo de log será gerado.
/LogToConsole={true|false} Se true, exibirá a saída no console. Se false (o padrão), suprimirá a saída no console.
/ShowCallStack A saída da pilha de chamadas será para o arquivo de log se ocorrer uma exceção a qualquer momento durante a instalação.
/u[ninstall] Desinstala os assemblies especificados. Diferentemente das outras opções, /u se aplica a todos os assemblies, independentemente de onde a opção seja exibida na linha de comando.

Opções adicionais do instalador

Os instaladores individuais usados em um assembly podem reconhecer opções além das listadas na seção Opções. Para saber mais sobre essas opções, execute InstallUtil.exe com os caminhos dos assemblies na linha de comando com a opção /? ou /help. Para especificar essas opções, você as inclui na linha de comando com as opções reconhecidas por InstallUtil.exe.

Observação

O texto da ajuda nas opções compatíveis com componentes do instalador individuais é retornado pela propriedade Installer.HelpText. As opções individuais que foram inseridas na linha de comando são acessíveis programaticamente com base na propriedade Installer.Context.

Todas as opções e os parâmetros de linha de comando são gravados no arquivo de log da instalação. No entanto, se você usar o /Password parâmetro, que é reconhecido por alguns componentes do instalador, as informações de senha serão substituídas por oito asteriscos (*) e não aparecerão no arquivo de log.

Importante

Em alguns casos, os parâmetros passados para o instalador podem incluir informações confidenciais ou de identificação pessoal que, por padrão, são gravadas em um arquivo de log de texto sem formatação. Para evitar esse comportamento, você pode suprimir o arquivo de log especificando /LogFile= (sem nenhum argumento de nome de arquivo ) na linha de comando.

Comentários

Os aplicativos do .NET Framework consistem em arquivos de programa tradicionais e recursos associados, como filas de mensagens, logs de eventos e contadores de desempenho, que devem ser criados quando o aplicativo é implantado. É possível usar componentes do instalador de um assembly para criar esses recursos quando o aplicativo é instalado e para removê-los quando o aplicativo é desinstalado. Installutil.exe detecta e executa esses componentes do instalador.

É possível especificar vários assemblies na mesma linha de comando. Qualquer opção ocorrida antes de um nome de assembly se aplica à instalação desse assembly. Com exceção de /u e /AssemblyName, as opções são cumulativas, mas substituíveis. Ou seja, as opções especificadas para um assembly se aplicam a todos os assemblies subsequentes, a menos que a opção seja especificada com um valor novo.

Se você executar Installutil.exe em um assembly sem especificar nenhuma opção, ele colocará estes três arquivos no diretório do assembly:

  • InstallUtil.InstallLog - Contém uma descrição geral do andamento da instalação.
  • assemblyname.InstallLog – Contém informações específicas para a fase de confirmação do processo de instalação. Para obter mais informações sobre a fase de confirmação, consulte o método Commit.
  • assemblyname.InstallState – Contém dados usados para desinstalar o assembly.

Installutil.exe usa reflexão para inspecionar os assemblies especificados e encontrar todos os tipos de Installer que têm o atributo System.ComponentModel.RunInstallerAttribute definido como true. Em seguida, a ferramenta executa o método Installer.Install ou Installer.Uninstall em cada instância do tipo de Installer. Installutil.exe realiza a instalação de maneira transacional; ou seja, se um dos assemblies não for instalado, ele reverterá as instalações de todos os outros assemblies. A desinstalação não é transacional.

Installutil.exe não pode instalar ou desinstalar assemblies assinados com atraso, mas pode instalar ou desinstalar assemblies de nome forte.

A versão de 32 bits do Common Language Runtime (CLR) é fornecida apenas com a versão de 32 bits da ferramenta Installer, mas a versão de 64 bits do CLR é fornecida com as versões de 32 bits e 64 bits da ferramenta Installer. Ao usar o CLR de 64 bits, use a ferramenta Instalador de 32 bits para instalar assemblies de 32 bits e a ferramenta Instalador de 64 bits para instalar assemblies de 64 bits e CIL (linguagem intermediária comum). Ambas as versões da ferramenta Instalador se comportam da mesma forma.

Você não pode usar Installutil.exe para implantar um serviço do Windows que foi criado usando C++, porque Installutil.exe não reconhece o código nativo incorporado que é produzido pelo compilador C++. Se você tentar implantar um serviço do Windows do C++ com Installutil.exe como, por exemplo, BadImageFormatException uma exceção será acionada. Para trabalhar com esse cenário, mova o código de serviço para o módulo do C++ e, em seguida, grave o objeto do instalador no C# ou no Visual Basic.

Exemplos

O comando a seguir exibe uma descrição da sintaxe e das opções de comando para InstallUtil.exe.

installutil /?

O comando a seguir exibe uma descrição da sintaxe e das opções de comando para InstallUtil.exe. Ele também exibirá uma descrição e uma lista de opções com suporte pelos componentes do instalador em myAssembly.exe se o texto de ajuda tiver sido atribuído à propriedade Installer.HelpText do instalador.

installutil /? myAssembly.exe

O comando a seguir executa os componentes do instalador no assembly myAssembly.exe.

installutil myAssembly.exe

O comando a seguir executa os componentes do instalador em um assembly usando-se a opção /AssemblyName e um nome totalmente qualificado.

installutil /AssemblyName "myAssembly, Culture=neutral, PublicKeyToken=0038abc9deabfle5, Version=4.0.0.0"

O comando a seguir executa os componentes do instalador em um assembly especificado pelo nome de arquivo e em um assembly especificado pelo nome forte. Todos os assemblies especificados pelo nome de arquivo devem anteceder assemblies especificados pelo nome forte na linha de comando, porque a opção /AssemblyName não pode ser substituída.

installutil myAssembly.exe /AssemblyName "myAssembly, Culture=neutral, PublicKeyToken=0038abc9deabfle5, Version=4.0.0.0"

O comando a seguir executa os componentes do desinstalador no assembly myAssembly.exe.

installutil /u myAssembly.exe

O comando a seguir executa os componentes do desinstalador nos assemblies myAssembly1.exe e myAssembly2.exe.

installutil myAssembly1.exe /u myAssembly2.exe

Como a posição da opção /u na linha de comando não é importante, ela equivale ao comando a seguir.

installutil /u myAssembly1.exe myAssembly2.exe

O comando a seguir executa os instaladores no assembly myAssembly.exe e especifica que as informações de andamento serão gravadas em myLog.InstallLog.

installutil /LogFile=myLog.InstallLog myAssembly.exe

O comando a seguir executa os instaladores no assembly myAssembly.exe, especifica que as informações de andamento devem ser gravadas em myLog.InstallLog e usa a opção /reg personalizada dos instaladores para especificar que as atualizações devem ser feitas no Registro do sistema.

installutil /LogFile=myLog.InstallLog /reg=true myAssembly.exe

O comando a seguir executa os instaladores no assembly myAssembly.exe, usa a opção /email personalizada do instalador para especificar o endereço de email do usuário e suprime saída para o arquivo de log.

installutil /LogFile= /email=admin@mycompany.com myAssembly.exe

O comando a seguir grava o andamento da instalação de myAssembly.exe em myLog.InstallLog e grava o andamento de myTestAssembly.exe em myTestLog.InstallLog.

installutil /LogFile=myLog.InstallLog myAssembly.exe /LogFile=myTestLog.InstallLog myTestAssembly.exe

Confira também