Compartilhar via


Ferramenta de instalador (InstallUtil.exe)

A ferramenta Installer permite instalar e desinstalar recursos do servidor, executando os componentes de instalação em um assembly especificado. Essa ferramenta funciona em conjunto com as classes no sistema.configuração.instalar do Namespace.

installutil [/uninstall][option [...]]assemblyname ]
[option [...]]assemblyname 

Comentários

Argumento

Descrição

AssemblyName

O nome do assembly no qual deseja executar os componentes do instalador.

Opção

Descrição

/h [elp]

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

/Help assemblypath

Exibe opções adicionais reconhecidas pelos instaladores individuais dentro do assembly especificado.

/?

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

/? assemblyPath

Exibe opções adicionais reconhecidas pelos instaladores individuais dentro do assembly especificado.

/ LogFile=nome de arquivo

Especifica o nome do arquivo de log onde instalar o progresso é gravado . O padrão é AssemblyName .InstallLog.

/AssemblyName assemblyName

, Versão =Major.minor.compilação.Revision

, Cultura =localidade

, PublicKeyToken =publicKeyToken]

Especifica o nome de um assembly. O nome do assembly deve ser totalmente qualificado com a versão, cultura e token de chave pública do assembly. O nome totalmente qualificado deve estar entre aspas.

Por exemplo, "myAssembly, cultura = neutral, PublicKeyToken = 0038abc9deabfle5, versão = 2.0.0.0" é um nome de assembly totalmente qualificado.

/ LogToConsole={True|False}

If True, exibe a saída no console. If False (padrão), suprime a saída no console.

/ ShowCallStack

Imprime a pilha de chamadas para o log se ocorrer uma exceção a qualquer momento durante a instalação.

/u[ninstall]

Desinstala um assembly. Ao contrário das outras opções, /u se aplica a todos os assemblies independentemente de onde ela aparece na linha de comando.

Comentários

Começando com o .NET estrutura versão 2.0, a versão de 32 bit do common linguagem tempo de execução (CLR) continua acompanham somente a versão de 32 bit da ferramenta Installer, mas a versão de 64 bit do CLR acompanha o 32 bit e uma versão de 64 bit da ferramenta Installer. Ao usar o CLR de 64 bit, use a ferramenta de Installer de 32 bit para instalar assemblies de 32 bit e a ferramenta do Installer de 64 bit para instalar 64 bit e Microsoft intermediate linguagem assemblies. Caso contrário, as duas versões da ferramenta Installer se comportam da mesma.

Aplicativos de estruturas Microsoft .NET consistem em arquivos de programa tradicionais e recursos associados, sistema autônomo filas de mensagens, logs de eventos e contadores de desempenho que devem ser criados quando o aplicativo for implantado. Você pode usar instalador de componentes de um assembly para criar esses recursos ao seu aplicativo está instalado e removê-los quando seu aplicativo é desinstalado. InstallUtil.exe detecta e executa esses componentes do instalador.

Você pode especificar vários conjuntos de módulos na mesma linha de comando. Qualquer opção que ocorre antes que um nome de assembly aplica-se à instalação do conjunto de módulos. Opções especificadas para um assembly se aplicam a todos os assemblies subseqüentes a menos que a opção seja especificada com um novo nome de assembly.

Se você executar Installutil.exe contra um assembly sem especificar nenhuma opção, ela coloca os três arquivos a seguir no diretório do assembly:

  • InstallUtil.InstallLog

    Contém uma descrição geral do progresso da instalação.

  • AssemblyName .InstallLog

    Contém informações específicas para a fase de confirmar do processo de instalação. Para obter mais informações sobre a fase de confirmar, consulte o Método Installer.confirmar.

  • AssemblyName .InstallState

    Contém dados usados para desinstalar o assembly.

InstallUtil.exe usa a reflexão para inspecionar o assembly especificado e localizar todos os Installer tipos com o RunInstallerAttribute definido como True. A ferramenta executa ambos o Método de instalar or the Desinstalar o método em cada instância do Instalador tipo. InstallUtil.exe realiza a instalação de forma transacional; se um dos conjuntos de módulos (assemblies) não instalar, ele desfaz as instalações de todos os outros assemblies. Desinstalar não é transacional.

InstallUtil.exe não pode instalar ou desinstalar atrasar assemblies assinados, mas pode instalar ou desinstalar fortes conjuntos nomeados.

Observe que não é possível implantar um serviço do Windows criado usando C++ com InstallUtil.exe. InstallUtil.exe não pode reconhecer o código nativo incorporado que é produzido pelo compilador C++. Se você tentar implantar um serviço do Windows do C++ com InstallUtil.exe, uma exceção, sistema autônomo BadImageFormatException será lançada. Para trabalhar com esse cenário, mova o código de serviço a um módulo de C++. Em seguida, escreva o objeto de instalador no translation from VPE for Csharp ou Visual Basic.

Exemplos

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

installutil

O seguinte comando executa os componentes de instalador no assembly myAssembly.exe.

installutil myAssembly.exe

O seguinte comando executa os componentes de instalação em um assembly usando comutador /AssemblyName e um nome totalmente qualificado.

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

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

installutil /u myAssembly.exe 

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

installutil /LogFile=myLog.InstallLog myAssembly.exe 

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

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

Consulte também

Referência

Ferramentas.NET Framework

System.Configuration.Install

Prompt de comando SDK