Share via


RegSvcs. exe (.Ferramenta de instalação de serviços NET)

A.Ferramenta de 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 os serviços que você tiver adicionado programaticamente à sua classe.

A.Ferramenta de instalação de serviços NET é instalada automaticamente com o Visual Studio. Para iniciar a ferramenta, use o Prompt de comando Visual Studio. No prompt de comando, digite o seguinte:

regsvcs [/c | /fc | /u] [/tlb:typeLibraryFile] [/extlb]
[/reconfig] [/componly] [/appname:applicationName]
[/nologo] [/quiet]assemblyFile.dll 

Parâmetros

Argumento

Descrição

assemblyFile.dll

O arquivo de assembly de origem. 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+ para localizar ou criar.

/c

Cria um aplicativo de destino.

/componly

Configura os componentes apenas; ignora os métodos e interfaces.

/exapp

Especifica a ferramenta para esperar um aplicativo existente.

/extlb

Usa uma biblioteca de tipo existente.

/FC

Localiza ou cria um 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 código do aplicativo COM+ 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 de assembly de origem especificado por assemblyFile.dll. Este assembly deve ser assinado com um nome forte. Para obter mais informações sobre a 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. O applicationName argumento pode ser gerado a partir do arquivo de assembly de origem e será criado por RegSvcs. exe, se ainda não existir. O typelibraryfile argumento pode especificar um nome de biblioteca de tipo. Se você não especificar um nome da biblioteca de tipos, RegSvcs. exe usa o nome do assembly como padrão.

Quando RegSvcs. exe registra os métodos do componente, ele está sujeito ao demandas e as demandas de link em um desses métodos. Como a ferramenta é executado em um ambiente totalmente confiável, a maioria das demandas de permissão será bem-sucedida. No entanto, o RegSvcs. exe não é possível registrar componentes com métodos protegidos por uma demanda de link ou por demanda para o StrongNameIdentityPermission ou PublisherIdentityPermission.

Você deve ter privilégios administrativos no computador local para usar RegSvcs. exe.

Se RegSvcs. exe falhar ao executar qualquer uma dessas ações, ele exibe mensagens de erro correspondente.

Exemplos

O comando a seguir adiciona todas as classes públicas contidas no myTest.dll para myTargetApp (um aplicativo COM+) e produz o myTest.tlb tipo de biblioteca.

regsvcs /appname:myTargetApp myTest.dll

O comando a seguir adiciona todas as classes públicas contidas no myTest.dll para myTargetApp (um aplicativo COM+) e produz o newTest.tlb tipo de biblioteca.

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

Consulte também

Tarefas

Como: Assinar um Assembly com um nome forte

Referência

Prompt de comando Visual Studio

Outros recursos

Ferramentas.NET Framework

Histórico de alterações

Date

History

Motivo

Junho de 2010

Removidas as designações de versão desatualizada.

Comentários do cliente.