Herramienta de configuración del modelo de servicio COM+ (ComSvcConfig.exe)
La herramienta de línea de comandos de configuración del modelo de servicios COM+ (ComSvcConfig.exe) le permite configurar interfaces de COM+ que se van a exponer como servicio Web.
Sintaxis
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]
Comentarios
Nota
Debe ser un administrador en el equipo local para utilizar ComSvcConfig.exe.
La herramienta se puede encontrar en la ubicación siguiente
%SystemRoot%\Microsoft.Net\Framework\v3.0\Windows Communication Foundation\
Para obtener más información sobre ComSvcConfig.exe, consulte Cómo usar la herramienta de configuración del modelo de servicio COM+.
La tabla siguiente describe los modos que se pueden utilizar con ComSvcConfig.exe.
| Opción | Descripción |
|---|---|
install |
Instala una configuración para una interfaz de COM+ para la integración del modelo de servicio. Forma abreviada: /i |
uninstall |
Desinstala una configuración para una interfaz de COM+ de la integración del modelo de servicio. Forma abreviada: /u |
list |
Hace una lista de información sobre las aplicaciones y componentes COM+ que tienen interfaces configuradas para la integración del modelo de servicio. Forma abreviada: /l |
La tabla siguiente describe los marcadores que se pueden utilizar con ComSvcConfig.exe.
| Opción | Descripción |
|---|---|
/application:<ApplicationID | ApplicationName> |
Especifica la aplicación COM+ que se va a configurar. Forma abreviada: /a |
/contract:<ClassID | ProgID | *,InterfaceID | InterfaceName | *> |
Especifica el componente y la interfaz COM+ que se configurarán como contrato para el servicio. Forma abreviada: /cAunque se puede utilizar el carácter comodín (*) al especificar los nombres de interfaz y componente, se recomienda no utilizarlo, porque podría exponer interfaces en las que no pensaba. |
/hosting:<complus | was> |
Especifica si utilizar el modo de alojamiento COM+ o el modo del alojamiento Web. Forma abreviada: /hPara utilizar el modo del alojamiento de COM+ se requiere activación explícita de la aplicación COM+. Utilizar el modo del alojamiento Web permite activar la aplicación COM+ automáticamente tal y como se requiere. Si la aplicación COM+ es una aplicación de biblioteca, se ejecuta en el proceso de Internet Information Services (IIS). Si la aplicación COM+ es una aplicación de servidor, se ejecuta en el proceso de Dllhost.exe. |
/webSite:<WebsiteName> |
Especifica el sitio web para alojamiento cuando se utiliza el modo de alojamiento Web (vea el marcador /hosting).Forma abreviada: /wSi no se especifica ningún sitio web, se utiliza el sitio web predeterminado. |
/webDirectory:<WebDirectoryName> |
Especifica el directorio virtual para alojamiento cuando se utiliza el alojamiento Web (vea el marcador /hosting).Forma abreviada: /d |
/mex |
Agrega un extremo de servicio de intercambio de metadatos (MEX) a la configuración de servicio predeterminada para admitir clientes que desean recuperar del servicio una definición del contrato. Forma abreviada: /x |
/id |
Muestra la información de aplicación, componente e interfaz como id. Forma abreviada: /k |
/nologo |
Evita que ComSvcConfig.exe muestre su logotipo. Forma abreviada: /n |
/verbose |
Genera todas las advertencias o el texto informativo además de los errores encontrados. Forma abreviada: /v |
/help |
Muestra el mensaje de uso. Forma abreviada: /? |
/partial |
Genera una configuración de servicio cuando la interfaz especificada incluye una o más firmas de método que se pueden exponer. En el momento de inicialización del servicio, aparecen métodos compatibles como operaciones en el contrato de servicios y los métodos no compatibles se omiten y no están presentes en el contrato de servicios. Si falta este marcador, la herramienta no generará una configuración de servicio cuando la interfaz especificada incluye uno o más métodos incompatibles. |
Ejemplos
Descripción
El ejemplo siguiente agrega la interfaz IFinances del componente ItemOrders.IFinancial (de la aplicación COM+ de OnlineStore) al conjunto de interfaces que se exponen como servicios web utilizando el modo del alojamiento COM+. Se generarán todas las advertencias además de cualquier error encontrado.
Código
ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus /verbose
Descripción
El ejemplo siguiente agrega la interfaz IStockLevels del componente ItemInventory.Warehouse (de la aplicación COM+ de OnlineWarehouse) al conjunto de interfaces que se exponen como servicios web utilizando el modo de alojamiento Web. El servicio Web está alojado en Web en el directorio virtual de OnlineWarehouse de IIS.
Código
ComSvcConfig.exe /install /application:OnlineWarehouse /contract:ItemInventory.Warehouse,IStockLevels /hosting:was /webDirectory:root/OnlineWarehouse
Descripción
El ejemplo siguiente quita la interfaz IFinances del componente ItemOrders.Financial (de la aplicación COM+ de OnlineStore) del conjunto de interfaces que se exponen como servicios web utilizando el modo del alojamiento COM+.
Código
ComSvcConfig.exe /uninstall /application:OnlineStore /interface:ItemOrders.Financial,IFinances /hosting:complus
Descripción
El ejemplo siguiente enumera las interfaces hospedadas en COM+ expuestas actualmente, junto con la dirección correspondiente y los detalles del enlace, para la aplicación OnlineStore COM+ en el equipo local.
Código
ComSvcConfig.exe /list /application:OnlineStore /hosting:complus