Cómo: Utilizar la herramienta configuración de modelos de servicio COM+

Cuando ha seleccionado un modo de hospedaje adecuado, utilice la herramienta de línea de comandos de configuración de modelos de servicio COM+ (ComSvcConfig.exe) para configurar las interfaces de aplicaciones que se expondrán como servicios web.

Nota

Debe ser un administrador en el equipo para realizar cualquiera de las tareas siguientes.

Para agregar una interfaz al conjunto de interfaces que se expondrán como servicios web, utilizando el modo de hospedaje de COM+

• Ejecute ComSvcConfig utilizando /install y las opciones /hosting:complus, como se muestra en el ejemplo siguiente.

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

  El comando agrega la interfaz IFinances del componente (de la aplicación OnlineStore COM+) ItemOrders.IFinancial al conjunto de interfaces que se expondrán como servicios web. El servicio utiliza el modo de hospedaje de COM+ y por consiguiente requiere la activación explícita de la aplicación.

  Aunque el carácter comodín de asterisco (*) se puede utilizar para el componente y la interfaz, evite utilizarlo porque podría desear exponer sólo la funcionalidad seleccionada como un servicio web. Si se ejecuta con una versión futura de este componente, al utilizar el carácter comodín se pueden exponer involuntariamente interfaces que pueden no haber estado presentes cuando se determinó la sintaxis de configuración.

  La opción /verbose indica a la herramienta que muestre las advertencias además de cualquier error.

  El contrato para el servicio expuesto contendrá todos los métodos de la interfaz IFinances.

Para agregar sólo métodos específicos de una interfaz al conjunto de interfaces que se expondrán como servicios web, utilizando el modo del alojamiento de COM+

• Ejecute ComSvcConfig utilizando /install y las opciones /hosting:complus con denominación explícita de los métodos necesarios, como se muestra en el ejemplo siguiente.

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

  El comando agrega sólo los métodos Credit y Debit de la interfaz IFinances como operaciones al contrato de servicios expuesto. Todos los otros métodos en la interfaz se omitirán del contrato y no podrán ser llamados por los clientes de servicios web.

Para agregar una interfaz al conjunto de interfaces que serán expuestas como servicios web, utilizando el modo de hospedaje web

• Ejecute ComSvcConfig utilizando la opción /install y la opción /hosting:was, como se muestra en el ejemplo siguiente.

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

  El comando agrega la interfaz IStockLevels en el componente ItemInventory.Warehouse (de la aplicación OnlineWarehouse COM+) al conjunto de interfaces que se expondrán como servicios web. El servicio está hospedado en Web en el directorio virtual de OnlineWarehouse de IIS en lugar de en COM+ y así la aplicación se activa automáticamente como se requiere.

  Para utilizar la configuración en proceso hospedada en Web, la aplicación COM+ se debe configurar para ejecutarse como una aplicación de biblioteca en lugar de una aplicación de servidor utilizando la consola de administración de Servicios de componentes. Las aplicaciones configuradas como aplicaciones de servidor utilizan el modo hospedado por Web estándar e incurren un salto de proceso para procesar cada solicitud.

  La opción /mex agrega un extremo de servicio adicional de Intercambio de metadatos (MEX) que utiliza el mismo transporte que el extremo de servicio de la aplicación para admitir clientes que desean recuperar una definición del contrato del servicio.

Para quitar un servicio Web para una interfaz especificada

• Ejecute ComSvcConfig utilizando la opción /uninstall, como se muestra en el ejemplo siguiente.

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

  El comando quita la interfaz IFinances del componente (de la aplicación OnlineStore COM+) ItemOrders.Financial.

Para hacer una lista de las interfaces actualmente expuestas

• Ejecute ComSvcConfig utilizando la opción /list, como se muestra en el ejemplo siguiente.

  ComSvcConfig.exe /list
  

  El comando hace una lista de las interfaces actualmente expuestas, junto con la dirección correspondiente y los detalles del enlace, y se pone a disposición del equipo local.

Para hacer una lista de interfaces específicas actualmente expuestas

• Ejecute ComSvcConfig utilizando la opción /list, como se muestra en el ejemplo siguiente.

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

  El comando hace una lista de las interfaces hospedadas por COM+ actualmente expuestas, junto con la dirección correspondiente y los detalles del enlace, para la aplicación OnlineStore COM+ en el equipo local.

Para mostrar la ayuda en las opciones que se pueden utilizar con la utilidad

• Ejecutar ComSvcConfig utilizando la opción /? , como se muestra en el ejemplo siguiente.

  ComSvcConfig.exe /?
  

Consulte también

Conceptos

Integración en la información general de las aplicaciones COM+