Herramienta de configuración del modelo de servicio COM+ (ComSvcConfig.exe)

La herramienta de línea de comandos com+ Service Model Configuration (ComSvcConfig.exe) permite configurar interfaces COM+ que se expongan como servicios 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]  

Observaciones

Nota:

Debe ser administrador en el equipo local para usar ComSvcConfig.exe.

La herramienta se puede encontrar en la siguiente ubicación.

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

Para obtener más información sobre ComSvcConfig.exe, vea How to: Use the COM+ Service Model Configuration Tool.

En la tabla siguiente se describen los modos que se pueden usar con ComSvcConfig.exe.

Opción	Descripción
install	Instala una configuración para una interfaz COM+ para la integración del modelo de servicio. Formato corto /i.
uninstall	Desinstala una configuración de una interfaz COM+ de la integración del Modelo de Servicio. Formato corto /u.
list	Muestra información sobre las aplicaciones y componentes com+ que tienen interfaces configuradas para la integración del modelo de servicio. Formato corto /l.

En la tabla siguiente se describen las marcas que se pueden usar con ComSvcConfig.exe.

Opción	Descripción
/application: < ApplicationID | ApplicationName>	Especifica la aplicación COM+ que se va a configurar. Formato corto /a.
/contract: < ClassID | ProgID | *,InterfaceID | InterfaceName | *>	Especifica el componente y la interfaz COM+ que se configurarán como contrato para el servicio. Formato corto /c. Aunque el carácter comodín (*) se puede usar al especificar los nombres de componente e interfaz, se recomienda no usarlo, ya que podría exponer interfaces que no tenía previsto.
/hosting: < complus | era>	Especifica si se va a usar el modo de hospedaje COM+ o el modo de hospedaje web. Formato corto /h. El uso del modo de hospedaje COM+ requiere la activación explícita de la aplicación COM+. El uso del modo de hospedaje web permite que la aplicación COM+ se active automáticamente según sea necesario. 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 hospedarse cuando se usa el modo de hospedaje web (vea la /hosting marca ). Formato corto /w. Si no se especifica ningún sitio web, se usa el sitio web predeterminado.
/webDirectory: < WebDirectoryName>	Especifica el directorio virtual para hospedarse cuando se usa el hospedaje web (vea la /hosting marca ). Formato corto /d.
/mex	Agrega un punto de conexión del servicio MEX (Intercambio de Metadatos) a la configuración predeterminada del servicio para admitir clientes que deseen obtener una definición de contrato del servicio. Formato corto /x.
/id	Muestra la información de la aplicación, el componente y la interfaz como identificadores. Formato corto /k.
/nologo	Impide que ComSvcConfig.exe muestre su logotipo. Formato corto /n.
/verbose	Genera todas las advertencias o el texto informativo, además de los errores detectados. Formato corto /v.
/help	Muestra el mensaje de uso. Formato corto /?.
/partial	Genera una configuración de servicio cuando la interfaz especificada incluye una o varias firmas de método que se pueden exponer. En el momento de la inicialización del servicio, los métodos compatibles aparecen como operaciones en el contrato de servicio y los métodos no compatibles se omiten y no están presentes en el contrato de servicio. Si falta esta marca, la herramienta no generará una configuración de servicio cuando la interfaz especificada incluya uno o varios 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

En el ejemplo siguiente se agrega la IStockLevels interfaz del ItemInventory.Warehouse componente (desde la aplicación COM+ OnlineWarehouse) al conjunto de interfaces que se exponen como servicios web mediante el modo de hospedaje web. El servicio web es Web hospedado en el directorio virtual 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  

Consulte también

• Cómo: Usar la herramienta de configuración del modelo de servicio COM+