Partilhar via

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

  • Artigo

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

Consulte também