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

  • Artigo

A ferramenta de Instalação dos Serviços .NET executa as seguintes ações:

  • Carrega e regista uma assemblagem.

  • Gera, regista e instala uma biblioteca de tipos numa aplicação COM+ especificada.

  • Configura os serviços que adicionou programaticamente à sua turma.

Para executar a ferramenta, utilize a Linha de Comandos para Programadores do Visual Studio ou o PowerShell para Programadores do Visual Studio.

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 ficheiro de assemblagem de origem. A assemblagem tem de ser assinada com um nome forte. Para obter mais informações, veja Assinar uma Assemblagem com um Nome Forte.
Opção Descrição
/appdir:path Especifica o diretório de raiz da aplicação.
/appname:applicationName Especifica o nome da aplicação COM+ para localizar ou criar.
/c Cria a aplicação de destino.
/componly Configura apenas componentes; ignora métodos e interfaces.
/exapp Especifica a ferramenta para esperar uma aplicação existente.
/extlb Utiliza uma biblioteca de tipos existente.
/fc Localiza ou cria a aplicação de destino.
/help Apresenta a sintaxe do comando e as opções da ferramenta.
/noreconfig Não reconfigura uma aplicação de destino existente.
/nologo Suprime o ecrã da faixa de arranque da Microsoft.
/parname:name Especifica o nome ou id da aplicação COM+ para localizar ou criar.
/reconfig Reconfigura uma aplicação de destino existente. Esta é a predefinição.
/tlb:typelibraryfile Especifica o tipo de ficheiro de biblioteca a instalar.
/u Desinstala a aplicação de destino.
/quiet Especifica o modo de sossego; suprime o logótipo e a apresentação da mensagem de êxito.
/? Apresenta a sintaxe do comando e as opções da ferramenta.

Observações

Regsvcs.exe requer um ficheiro de assemblagem de origem especificado pelo assemblyFile.dll. Esta assemblagem tem de ser assinada com um nome forte. Para obter mais informações sobre a assinatura de nomes fortes, consulte Assinar uma Assemblagem com um Nome Forte. Os nomes da aplicação de destino e do ficheiro de biblioteca de tipo são opcionais. O argumento applicationName pode ser gerado a partir do ficheiro de assemblagem de origem e será criado por Regsvcs.exe, se ainda não existir. O argumento typelibraryfile pode especificar um nome de biblioteca de tipo. Se não especificar um nome de biblioteca de tipo, Regsvcs.exe utiliza o nome da assemblagem como predefinição.

Quando Regsvcs.exe regista os métodos de um componente, está sujeito às exigências e às exigências de ligação nesses métodos. Uma vez que a ferramenta é executada num ambiente totalmente fidedigno, a maioria exige uma permissão com êxito. No entanto, Regsvcs.exe não consegue registar componentes com métodos protegidos por uma procura ou ligação para o StrongNameIdentityPermission ou o PublisherIdentityPermission.

Tem de ter privilégios administrativos no computador local para utilizar Regsvcs.exe.

Se Regsvcs.exe falhar durante a execução de qualquer uma destas ações, apresenta as mensagens de erro correspondentes.

Exemplos

O comando seguinte adiciona todas as classes públicas contidas em myTest.dll (uma aplicação myTargetApp COM+ existente) e produz a biblioteca de myTest.tlb tipos.

regsvcs /appname:myTargetApp myTest.dll

O comando seguinte adiciona todas as classes públicas contidas em myTest.dll (uma aplicação myTargetApp COM+ existente) e produz a biblioteca de newTest.tlb tipos.

regsvcs /appname:myTargetApp /tlb:newTest.tlb myTest.dll

Ver também