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