如何:使用 COM+ 服务模型配置工具

在选择了适当的宿主模式之后,就可使用 COM+ 服务模型配置命令行工具 (ComSvcConfig.exe) 来配置将作为 Web 服务公开的应用程序接口。

提示

您必须具有计算机上的管理员身份,才能执行下列各项任务。

使用 COM+ 宿主模式将接口添加到将作为 Web 服务公开的接口集

  • 使用 /install/hosting:complus 选项运行 ComSvcConfig,如下面的示例所示。

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

    此命令将 ItemOrders.IFinancial 组件(它属于 OnlineStore COM+ 应用程序)的 IFinances 接口添加到将作为 Web 服务公开的接口集。此服务使用 COM+ 宿主模式,因此要求显式激活应用程序。

    虽然可以将通配符星号 (*) 字符用于组件和接口,但应避免使用它,因为您可能希望仅将选定的功能作为 Web 服务公开。如果对此组件的将来版本运行命令,则使用通配符可能意外地公开在确定配置语法时尚不存在的接口。

    /verbose 选项指示该工具除显示所有错误以外,还要显示警告。

    所公开的服务的协定将包含 IFinances 接口中的所有方法。

使用 COM+ 宿主模式,仅将接口中的特定方法添加到将作为 Web 服务公开的接口集

  • 使用 /install/hosting:complus 选项以及所需方法的显式命名运行 ComSvcConfig,如下面的示例所示。

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

    此命令仅将 IFinances 接口中的 CreditDebit 方法作为操作添加到所公开的服务协定中。此接口中的其他所有方法将在协定中省略,并且无法从 Web 服务客户端调用。

使用 Web 宿主模式将接口添加到将作为 Web 服务公开的接口集

  • 使用 /install 选项和 /hosting:was 选项运行 ComSvcConfig,如下面的示例所示。

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

    此命令将 ItemInventory.Warehouse 组件(它属于 OnlineWarehouse COM+ 应用程序)的 IStockLevels 接口添加到将作为 Web 服务公开的接口集。此服务以 Web 方式承载在 IIS 的 OnlineWarehouse 虚拟目录中,而不是承载在 COM+ 中,因此应用程序将根据需要自动激活。

    若要使用 Web 承载的进程内配置,必须使用组件服务管理控制台将 COM+ 应用程序配置为作为库应用程序而不是服务器应用程序运行。被配置为服务器应用程序的应用程序使用标准 Web 承载模式,并促使进程跃点处理每个请求。

    /mex 选项用于添加其他元数据交换 (MEX) 服务终结点,它们与应用程序的服务终结点使用相同的传输协议,以支持要从服务中检索协定定义的客户端。

移除指定接口的 Web 服务

  • 使用 /uninstall 选项运行 ComSvcConfig,如下面的示例所示。

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

    此命令将移除 ItemOrders.Financial 组件(它属于 OnlineStore COM+ 应用程序)上的 IFinances 接口。

列出当前公开的接口

  • 使用 /list 选项运行 ComSvcConfig,如下面的示例所示。

    ComSvcConfig.exe /list
    

    此命令列出当前公开的接口以及相应的地址和绑定详细信息,范围局限于本地计算机。

列出当前公开的特定接口

  • 使用 /list 选项运行 ComSvcConfig,如下面的示例所示。

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

    此命令列出当前公开的 COM+ 承载接口以及相应的地址和绑定详细信息,范围局限于本地计算机上的 OnlineStore COM+ 应用程序。

显示可与此实用工具一起使用的选项的帮助

  • 使用 /? 选项运行 ComSvcConfig,如下面的示例所示。

    ComSvcConfig.exe /?
    

另请参见

概念

与 COM+ 应用程序集成的概述