Regsvcs.exe (Ferramenta de Instalação de Serviços .NET)
A ferramenta Instalação de Serviços .NET realiza as seguintes ações:
Carrega e registra um assembly.
Gera, registra e instala uma biblioteca de tipos em um aplicativo COM+ especificado.
Configura serviços adicionados programaticamente à classe.
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
regsvcs [/c | /fc | /u] [/tlb:typeLibraryFile] [/extlb]
[/reconfig] [/componly] [/appname:applicationName]
[/nologo] [/quiet]assemblyFile.dll
Parâmetros
| Argumento | Descrição |
|---|---|
| assemblyFile.dll | O arquivo do assembly de origem. O assembly deve ser assinado com um nome forte. Para obter mais informações, consulte Assinando um assembly com um nome forte. |
| Opção | Descrição |
|---|---|
| /appdir: caminho | Especifica o diretório raiz do aplicativo. |
| /nomedoaplicativo: nome_do_aplicativo | Especifica o nome do aplicativo COM+ a ser encontrado ou criado. |
| /c | Cria o aplicativo de destino. |
| /componly | Configura apenas componentes; ignora métodos e interfaces. |
| /exapp | Especifica a ferramenta para aguardar um aplicativo existente. |
| /extlb | Usa uma biblioteca de tipos existente. |
| /fc | Encontra ou cria o aplicativo de destino. |
| /help | Exibe sintaxe de comando e opções para a 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 a ID do aplicativo COM+ a ser encontrado ou criado. |
| /reconfig | Reconfigura um aplicativo de destino existente. Esse é o padrão. |
| /tlb: typelibraryfile | Especifica a biblioteca de tipos a ser instalada. |
| /u | Desinstala o aplicativo de destino. |
| /quiet | Especifica o modo silencioso; suprime o logotipo e a exibição da mensagem de êxito. |
| /? | Exibe sintaxe de comando e opções para a ferramenta. |
Comentários
O Regsvcs.exe exige um arquivo do assembly de origem especificado por assemblyFile.dll. Esse assembly deve ser assinado com um nome forte. Para obter mais informações sobre a assinatura de nome forte, consulte Assinando um assembly com um nome forte. Os nomes do aplicativo de destino e do arquivo da biblioteca de tipos são opcionais. O argumento applicationName pode ser gerado com base no arquivo do assembly de origem e será criado por Regsvcs.exe, se ainda não existir. O argumento typelibraryfile pode especificar um nome da biblioteca de tipos. Se você não especificar um nome da biblioteca de tipos, Regsvcs.exe usará o nome do assembly como o padrão.
Quando Regsvcs.exe registra os métodos de um componente, ele está sujeito a demandas e demandas de link nesses métodos. Como a ferramenta é executada em um ambiente totalmente confiável, a maioria das demandas de uma permissão é bem-sucedida. No entanto, Regsvcs.exe não pode registrar componentes com métodos protegidos por uma demanda ou uma exigência de vínculo para StrongNameIdentityPermission ou PublisherIdentityPermission.
Você deve ter privilégios administrativos no computador local para usar Regsvcs.exe.
Se falhar durante a realização de alguma dessas ações, Regsvcs.exe exibirá mensagens de erro correspondentes.
Exemplos
O comando a seguir adiciona todas as classes públicas contidas em myTest.dll a myTargetApp (um aplicativo COM+ existente) e produz a biblioteca de tipos myTest.tlb.
regsvcs /appname:myTargetApp myTest.dll
O comando a seguir adiciona todas as classes públicas contidas em myTest.dll a myTargetApp (um aplicativo COM+ existente) e produz a biblioteca de tipos newTest.tlb.
regsvcs /appname:myTargetApp /tlb:newTest.tlb myTest.dll
