Compartir a través de

Procedimiento para usar la herramienta configuración de modelos de servicio COM+

  • Artículo

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.

Al usar ComSvcConfig.exe en un equipo con Windows 7 para configurar un servicio web con la finalidad de usar la última versión de modelo de servicio (actualmente, la versión 4.5), lleve a cabo los siguientes pasos:

  1. Establezca la clave del registro [HKEY_LOCAL_COMPUTER\SOFTWARE\Microsoft\.NETFramework]\OnlyUseLatestCLR en un valor DWORD de 0x00000001

  2. Ejecute comsvcconfig.exe

  3. Revierta la clave del Registro agregada en el paso 1 a su valor original, o elimínela si no existía.

Importante

Es importante revertir esta clave del Registro. Se trata de una clave de compatibilidad. Si no se revierte este cambio, se pueden producir problemas con otras aplicaciones .NET activas en el equipo.

Advertencia

Al usar ComSvcConfig.exe /install en un equipo con Windows 8, se muestra un cuadro de diálogo que indica "Una aplicación de su equipo necesita la siguiente característica de Windows: .NET Framework 3.5 (incluye .NET 2.0 y .NET 3.0)" si no se ha instalado .NET Framework 3.5. Se puede omitir este cuadro de diálogo. También puede establecer la clave del Registro OnlyUseLatestCLR a un valor DWORD de 0x00000001

Adición de una interfaz mediante el modo de hospedaje 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 solo 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.

Adición de métodos específicos desde una interfaz mediante el modo de hospedaje 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 solo 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.

Adición de una interfaz mediante 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.

Eliminación de 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.

Enumeración de interfaces expuestas actualmente

  • 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.

Enumeración de interfaces específicas expuestas actualmente

  • 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.

Mostrar ayuda para las opciones

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

    ComSvcConfig.exe /?

Consulte también