Compartilhar via


Ferramenta de Configuração do Modelo de Serviço COM+ (ComSvcConfig.exe)

A ferramenta de linha de comando configuração de modelo de serviço COM+ (ComSvcConfig.exe) permite que você configure interfaces COM+ a serem expostas como serviços Web.

Sintaxe

ComSvcConfig.exe /install | /uninstall | /list [/application:<ApplicationID | ApplicationName>] [/contract:<ClassID | ProgID | *,InterfaceID | InterfaceName | *>] [/hosting:<complus | was>] [/webSite:<WebsiteName>] [/webDirectory:<WebDirectoryName>] [/mex] [/id] [/nologo] [/verbose] [/help] [/partial]  

Observações

Observação

Você deve ser um administrador no computador local para usar ComSvcConfig.exe.

A ferramenta pode ser encontrada no local a seguir

%SystemRoot%\Microsoft.Net\Framework\v3.0\Windows Communication Foundation\

Para obter mais informações sobre ComSvcConfig.exe, consulte Como usar a Ferramenta de Configuração do Modelo de Serviço COM+.

A tabela a seguir descreve os modos que podem ser usados com ComSvcConfig.exe.

Opção Descrição
install Instala uma configuração para uma interface COM+ para integração do Modelo de Serviço.

Forma abreviada /i.
uninstall Desinstala a configuração de uma interface COM+ para integração do Modelo de Serviço.

Forma abreviada /u.
list Lista informações sobre aplicativos e componentes COM+ que têm interfaces configuradas para integração do Modelo de Serviço.

Forma abreviada /l.

A tabela a seguir descreve os sinalizadores que podem ser usados com ComSvcConfig.exe.

Opção Descrição
/application: < ApplicationID | ApplicationName> Especifica o aplicativo COM+ a ser configurado.

Forma abreviada /a.
/contract: < ClassID | ProgID | *,InterfaceName da InterfaceID | | *> Especifica o componente e a interface COM+ que serão configurados como o contrato do serviço.

Forma abreviada /c.

Embora o caractere curinga (*) possa ser usado quando você especificar os nomes de componente e interface, recomendamos que você não o use, pois você pode expor interfaces que você não pretendia.
/hosting: < complus | era> Especifica se o modo de hospedagem COM+ ou o modo de hospedagem da Web deve ser usado.

Forma abreviada /h.

Usar o modo de hospedagem COM+ requer a ativação explícita do aplicativo COM+. Usar o modo de hospedagem da Web permite que o aplicativo COM+ seja ativado automaticamente conforme necessário. Se o aplicativo COM+ for um aplicativo de biblioteca, ele será executado no processo dos Serviços de Informações da Internet (IIS). Se o aplicativo COM+ for um aplicativo de servidor, ele será executado no processo de Dllhost.exe.
/webSite: < WebsiteName> Especifica o site para hospedagem quando o modo de hospedagem da Web é usado (consulte o /hosting sinalizador).

Forma abreviada /w.

Se nenhum site for especificado, o site padrão será usado.
/webDirectory: < WebDirectoryName> Especifica o diretório virtual para hospedagem quando a hospedagem da Web é usada (consulte o /hosting sinalizador).

Forma abreviada /d.
/mex Adiciona um ponto de extremidade de serviço de intercâmbio de metadados (MEX) à configuração do serviço padrão para dar suporte a clientes que desejam recuperar uma definição de contrato do serviço.

Forma abreviada /x.
/id Exibe as informações de aplicativo, componente e interface como IDs.

Forma abreviada /k.
/nologo Impede que ComSvcConfig.exe exiba seu logotipo.

Forma abreviada /n.
/verbose Gera todos os avisos ou texto informativo, além de quaisquer erros encontrados.

Forma abreviada /v.
/help Exibe a mensagem de uso.

Forma abreviada /?.
/partial Gera uma configuração de serviço quando a interface especificada inclui uma ou mais assinaturas de método que podem ser expostas. No momento da inicialização do serviço, métodos compatíveis aparecem como operações no contrato de serviço e métodos não compatíveis são ignorados e ausentes do contrato de serviço.

Se esse sinalizador estiver ausente, a ferramenta não gerará uma configuração de serviço quando a interface especificada incluir um ou mais métodos incompatíveis.

Exemplos

Descrição

O exemplo a seguir adiciona a IFinances interface do ItemOrders.IFinancial componente (do aplicativo OnlineStore COM+) ao conjunto de interfaces expostas como serviços Web, usando o modo de hospedagem COM+. Todos os avisos serão gerados além de quaisquer erros encontrados.

Código

ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus /verbose  

Descrição

O exemplo a seguir adiciona a IStockLevels interface do ItemInventory.Warehouse componente (do aplicativo OnlineWarehouse COM+) ao conjunto de interfaces expostas como serviços Web, usando o modo de hospedagem da Web. O serviço Web é hospedado na Web no diretório virtual onlineWarehouse do IIS.

Código

ComSvcConfig.exe /install /application:OnlineWarehouse /contract:ItemInventory.Warehouse,IStockLevels /hosting:was /webDirectory:root/OnlineWarehouse  

Descrição

O exemplo a seguir remove a IFinances interface do ItemOrders.Financial componente (do aplicativo OnlineStore COM+) do conjunto de interfaces expostas como serviços Web.

Código

ComSvcConfig.exe /uninstall /application:OnlineStore /interface:ItemOrders.Financial,IFinances /hosting:complus  

Descrição

O exemplo a seguir lista as interfaces hospedadas no host COM+ expostas no momento, junto com o endereço de correspondência e os detalhes da associação, para o aplicativo OnlineStore COM+ no computador local.

Código

ComSvcConfig.exe /list /application:OnlineStore /hosting:complus  

Consulte também