Regsvcs.exe (Ferramenta de Instalação de Serviços .NET)

  • Artigo

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:path Especifica o diretório raiz do aplicativo.
/appname:applicationName 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:name 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

Confira também