Ferramenta de configuração de 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]
Comentários
Observação
Você deve ser um administrador no computador local para usar o ComSvcConfig.exe.
A ferramenta pode ser encontrada nos seguintes locais
%SystemRoot%\Microsoft.Net\Framework\v3.0\Windows Communication Foundation\
Para obter mais informações sobre o ComSvcConfig.exe, confira Como usar a ferramenta de configuração de 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 a configuração de 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 a 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 | *,InterfaceID | InterfaceName | *> |
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 ativação explícita do aplicativo COM+. O uso do 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 Dllhost.exe. |
/webSite:<WebsiteName> |
Especifica o site para hospedagem quando o modo de hospedagem da Web é usado (confira o sinalizador /hosting).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 (confira o sinalizador /hosting).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 informações de aplicativo, componente e de 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 dos 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, os métodos compatíveis aparecem como operações no contrato de serviço e os 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 interface IFinances do componente ItemOrders.IFinancial (do aplicativo OnlineStore COM+) ao conjunto de interfaces que serão 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 interface IStockLevels do componente ItemInventory.Warehouse (do aplicativo OnlineWarehouse COM+) ao conjunto de interfaces que serão expostas como serviços Web, usando o modo de hospedagem na 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 interface IFinances do componente ItemOrders.Financial (do aplicativo OnlineStore COM+) do conjunto de interfaces que serão 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