Regsvcs.exe (Ferramenta de Instalação de Serviços .NET)
A ferramenta de instalação de serviços .NET executa as seguintes ações:
Carrega e registra um assembly.
Gera, registra e instala uma biblioteca de tipos em um aplicativo COM+ especificado.
Configura os serviços que você adicionou programaticamente à sua classe.
Para executar a ferramenta, use o Visual Studio Developer Command Prompt ou o Visual Studio Developer PowerShell.
Na linha de comandos, escreva o seguinte:
Sintaxe
regsvcs [/c | /fc | /u] [/tlb:typeLibraryFile] [/extlb]
[/reconfig] [/componly] [/appname:applicationName]
[/nologo] [/quiet]assemblyFile.dll
Parâmetros
| Argumento | Description |
|---|---|
| assemblyFile.dll | O arquivo de assembly de origem. A assembleia deve ser assinada com um nome forte. Para obter mais informações, consulte Assinando um assembly com um nome forte. |
| Opção | Description |
|---|---|
| /appdir: caminho | Especifica o diretório raiz do aplicativo. |
| /appname: nome_do_aplicativo | Especifica o nome do aplicativo COM+ a ser localizado ou criado. |
| /c | Cria o aplicativo de destino. |
| /componly | Configura apenas componentes; ignora métodos e interfaces. |
| /exApp | Especifica para a ferramenta esperar um aplicativo existente. |
| /extlb | Usa uma biblioteca de tipos existente. |
| /FC | Localiza ou cria o aplicativo de destino. |
| /Ajuda | Exibe a sintaxe do comando e as opções da ferramenta. |
| /noreconfig | Não reconfigura um aplicativo de destino existente. |
| /nologo | Suprime a exibição do banner de inicialização da Microsoft. |
| /parname: nome | Especifica o nome ou id do aplicativo COM+ para localizar ou criar. |
| /reconfig | Reconfigura um aplicativo de destino existente. Esta é a predefinição. |
| /tlb: typelibraryfile | Especifica o arquivo de biblioteca de tipos a ser instalado. |
| /u | Desinstala o aplicativo de destino. |
| /silencioso | Especifica o modo silencioso; suprime a exibição do logotipo e da mensagem de sucesso. |
| /? | Exibe a sintaxe do comando e as opções da ferramenta. |
Observações
Regsvcs.exe requer um arquivo de assembly de origem especificado por assemblyFile.dll. Esta montagem deve ser assinada com um nome forte. Para obter mais informações sobre assinatura de nome forte, consulte Assinando um assembly com um nome forte. Os nomes do aplicativo de destino e do arquivo de biblioteca de tipos são opcionais. O argumento applicationName pode ser gerado a partir do arquivo assembly de origem e será criado por Regsvcs.exe, se ainda não existir. O argumento typelibraryfile pode especificar um nome de biblioteca de tipos. Se você não especificar um nome de biblioteca de tipos, Regsvcs.exe usará o nome do assembly como padrão.
Quando Regsvcs.exe registra os métodos de um componente, ele está sujeito às demandas e às demandas de link sobre esses métodos. Como a ferramenta é executada em um ambiente totalmente confiável, a maioria das demandas por uma permissão é bem-sucedida. No entanto, Regsvcs.exe não pode registrar componentes com métodos protegidos por uma demanda ou demanda de link para o StrongNameIdentityPermission ou o PublisherIdentityPermission.
Você deve ter privilégios administrativos no computador local para usá Regsvcs.exe.
Se Regsvcs.exe falhar ao executar qualquer uma dessas ações, ele exibirá as mensagens de erro correspondentes.
Exemplos
O comando a seguir adiciona todas as classes públicas contidas em myTest.dll myTargetApp (um aplicativo COM+ existente) e produz a biblioteca de myTest.tlb tipos.
regsvcs /appname:myTargetApp myTest.dll
O comando a seguir adiciona todas as classes públicas contidas em myTest.dll myTargetApp (um aplicativo COM+ existente) e produz a biblioteca de newTest.tlb tipos.
regsvcs /appname:myTargetApp /tlb:newTest.tlb myTest.dll
