Ferramenta de instalação de serviços do .NET (RegSvcs.exe)
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 + 1.0 especificado.
Configura os serviços que você adicionou por programação à sua classe.
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 fonte. O assembly deve ser assinado com um nome forte. Para obter mais informações, consulte Assinar um assembly com um nome forte. |
Opção |
Descrição |
|---|---|
/appdir:caminho |
Especifica o diretório raiz do aplicativo. |
/appname:applicationName |
Especifica o nome do aplicativo COM + 1.0 para localizar ou criar. |
/c |
Cria um aplicativo de destino. |
/componly |
Configura somente componentes; ignora métodos e interfaces. |
/exapp |
Especifica que a ferramenta esperar que um aplicativo existente. |
/extlb |
Usa uma biblioteca de tipo existente. |
/FC |
Localiza ou cria o aplicativo de destino. |
/help |
Exibe sintaxe de comando e opções para a ferramenta. |
/noreconfig |
Não reconfigurar um aplicativo de destino existente. |
/nologo |
Suprime a exibição Microsoft faixa de inicialização. |
/parname:nome |
Especifica o nome ou id do aplicativo COM + 1.0 para localizar ou criar. |
/reconfig |
Reconfigura um aplicativo de destino existente. Este é o padrão. |
/tlb:typelibraryfile |
Especifica o arquivo de biblioteca de tipo para instalar. |
/u |
Desinstala o aplicativo de destino. |
/quiet |
Especifica o modo silencioso; suprime a exibição de mensagem de sucesso e o logotipo. |
/? |
Exibe sintaxe de comando e opções para a ferramenta. |
Comentários
RegSvcs.exe requer um arquivo do assembly de fonte especificado por assemblyFile.dll. Este assembly deve ser assinado com um nome forte. Para obter mais informações sobre assinatura de nome forte, consulte Assinar um assembly com um nome forte. Os nomes do aplicativo de destino e o arquivo de biblioteca de tipo são opcionais. The applicationName argumento pode ser gerado do arquivo do assembly de fonte e será criado por RegSvcs.exe, se ele já não existe. The typelibraryfile argumento pode especificar um nome de tipo de biblioteca. Se você não especificar um nome de tipo de biblioteca, RegSvcs.exe usará o nome do assembly sistema autônomo padrão.
Quando RegSvcs.exe registra métodos do componente, ele está sujeito ao demandas and demandas de link sobre esses métodos. Como a ferramenta é executado em um ambiente totalmente confiável, a maioria das demandas por uma permissão seja bem-sucedida. No entanto, o regsvcs.exe não é possível registrar componentes com métodos protegidos por uma demanda de link ou por solicitação para o StrongNameIdentityPermission ou o PublisherIdentityPermission.
Você deve ter privilégios administrativos no computador local para usar o regsvcs.exe.
Se RegSvcs.exe falhar ao executar essas ações, ela exibirá mensagens de erro correspondentes. Para obter uma descrição mais detalhada de possíveis falhas e mensagens de erro, consulte Registrando manualmente um assembly.
Exemplos
O comando a seguir adiciona todas as classes públicas contidas em myTest.dll para myTargetApp (um aplicativo COM + 1.0 existente) e produz a myTest.tlb biblioteca de tipos.
regsvcs /appname:myTargetApp myTest.dll
O comando a seguir adiciona todas as classes públicas contidas em myTest.dll para myTargetApp (um aplicativo COM + 1.0 existente) e produz a newTest.tlb biblioteca de tipos.
regsvcs /appname:myTargetApp /tlb:newTest.tlb myTest.dll
Consulte também
Tarefas
Como: Assinar um assembly com um nome forte