Ferramenta de configuração do modelo de serviço COM+ (ComSvcConfig.exe)
A ferramenta de linha de comando COM+ Service Model Configuration (ComSvcConfig.exe) permite configurar interfaces COM+ para 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
Nota
Você deve ser um administrador no computador local para usá ComSvcConfig.exe.
A ferramenta pode ser encontrada no seguinte local
%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 | Description |
|---|---|
install |
Instala uma configuração para uma interface COM+ para integração do Modelo de Serviço. Forma /iabreviada . |
uninstall |
Desinstala uma configuração para uma interface COM+ da integração do Modelo de Serviço. Forma /uabreviada . |
list |
Lista informações sobre aplicativos COM+ e componentes que possuem interfaces configuradas para integração do Modelo de Serviço. Forma /labreviada . |
A tabela a seguir descreve os sinalizadores que podem ser usados com ComSvcConfig.exe.
| Opção | Description |
|---|---|
/application:<ApplicationID | ApplicationName> |
Especifica o aplicativo COM+ a ser configurado. Forma /aabreviada . |
/contract:<ClassID | ProgID | *,InterfaceID | InterfaceName | *> |
Especifica o componente COM+ e a interface que serão configurados como o contrato para o serviço. Forma /cabreviada .Embora o caractere curinga (*) possa ser usado quando você especifica os nomes de componentes e interfaces, recomendamos que você não o use, porque você pode expor interfaces que não pretendia. |
/hosting:<complus | foi> |
Especifica se o modo de hospedagem COM+ ou o modo de hospedagem na Web devem ser usados. Forma /habreviada .Usar o modo de hospedagem COM+ requer ativação explícita do aplicativo COM+. O uso do modo de hospedagem na 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 do IIS (Serviços de Informações da Internet). Se o aplicativo COM+ for um aplicativo de servidor, ele será executado no processo Dllhost.exe. |
/webSite:<Nome do site> |
Especifica o site para hospedagem quando o modo de hospedagem na Web é usado (consulte o /hosting sinalizador).Forma /wabreviada .Se nenhum site for especificado, o site padrão será usado. |
/webDirectory:<WebDirectoryName> |
Especifica o diretório virtual para hospedagem quando a hospedagem na Web é usada (consulte o /hosting sinalizador).Forma /dabreviada . |
/mex |
Adiciona um ponto de extremidade de serviço de troca de metadados (MEX) à configuração de serviço padrão para oferecer suporte a clientes que desejam recuperar uma definição de contrato do serviço. Forma /xabreviada . |
/id |
Exibe as informações do aplicativo, componente e interface como IDs. Forma /kabreviada . |
/nologo |
Impede que ComSvcConfig.exe exiba seu logotipo. Forma /nabreviada . |
/verbose |
Gera todos os avisos ou texto informativo, além de quaisquer erros encontrados. Forma /vabreviada . |
/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
Description
O exemplo a seguir adiciona a IFinances interface do ItemOrders.IFinancial componente (do aplicativo OnlineStore COM+) ao conjunto de interfaces que são expostas como serviços Web, usando o modo de hospedagem COM+. Todos os avisos serão produzidos, além de quaisquer erros encontrados.
Código
ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus /verbose
Description
O exemplo a seguir adiciona a IStockLevels interface do ItemInventory.Warehouse componente (do aplicativo OnlineWarehouse COM+) ao conjunto de interfaces que sã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
Description
O exemplo a seguir remove a IFinances interface do ItemOrders.Financial componente (do aplicativo OnlineStore COM+) do conjunto de interfaces que são expostas como serviços da Web.
Código
ComSvcConfig.exe /uninstall /application:OnlineStore /interface:ItemOrders.Financial,IFinances /hosting:complus
Description
O exemplo a seguir lista interfaces hospedadas COM+ atualmente expostas, juntamente com o endereço correspondente e detalhes de vinculação, para o aplicativo OnlineStore COM+ na máquina local.
Código
ComSvcConfig.exe /list /application:OnlineStore /hosting:complus