COM+ 服务模型配置命令行工具(ComSvcConfig.exe)使你可以将 COM+ 接口配置为作为 Web 服务公开。
语法
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]
注解
注释
必须是本地计算机上的管理员才能使用 ComSvcConfig.exe。
可以在以下位置找到该工具
%SystemRoot%\Microsoft.Net\Framework\v3.0\Windows Communication Foundation\
有关 ComSvcConfig.exe的详细信息,请参阅 如何:使用 COM+ 服务模型配置工具。
下表介绍可用于 ComSvcConfig.exe 的模式。
选项 | DESCRIPTION |
---|---|
install |
为用于服务模型集成的 COM+ 接口安装配置。 短格式 /i 。 |
uninstall |
从服务模型集成中卸载 COM+ 接口的配置。 短格式 /u 。 |
list |
列出有关 COM+ 应用程序和组件的信息,这些组件具有为服务模型集成配置的接口。 短格式 /l 。 |
下表描述了可以与 ComSvcConfig.exe一同使用的各个标志。
选项 | DESCRIPTION |
---|---|
/application:
<
ApplicationID | ApplicationName> |
指定要配置的 COM+ 应用程序。 短格式 /a 。 |
/contract:
<
ClassID | ProgID |*,InterfaceID | InterfaceName | *> |
指定将作为服务协定配置的 COM+ 组件和接口。 短格式 /c 。虽然指定组件和接口名称时可以使用通配符 \ , 但建议不要使用它,因为你可能会公开你不打算使用的接口。 |
/hosting:
<
complus | 是> |
指定是使用 COM+ 托管模式还是 Web 托管模式。 短格式 /h 。使用 COM+ 托管模式需要显式激活 COM+ 应用程序。 使用 Web 托管模式,可以根据需要自动激活 COM+ 应用程序。 如果 COM+ 应用程序是库应用程序,它将在 Internet Information Services (IIS) 进程中运行。 如果 COM+ 应用程序是服务器应用程序,则会在 Dllhost.exe 进程中运行。 |
/webSite:
<
WebsiteName> |
指定使用 Web 托管模式时用于托管的网站(请参阅 /hosting 标志)。短格式 /w 。如果未指定网站,则使用默认网站。 |
/webDirectory:
<
WebDirectoryName> |
指定使用 Web 托管时的虚拟目录,以用于主机服务(请参阅 /hosting 标志)。短格式 /d 。 |
/mex |
将元数据交换 (MEX) 服务终结点添加到默认服务配置,以支持要从服务中检索协定定义的客户端。 短格式 /x 。 |
/id |
将应用程序、组件和接口信息显示为 ID。 短格式 /k 。 |
/nologo |
阻止 ComSvcConfig.exe 显示其徽标。 短格式 /n 。 |
/verbose |
输出所有警告或信息性文本,以及遇到的任何错误。 短格式 /v 。 |
/help |
显示使用情况消息。 短格式 /? 。 |
/partial |
当指定的接口包含一个或多个可公开的方法签名时,生成服务配置。 在服务初始化时,兼容的方法显示为服务协定中的操作,而不兼容的方法则被忽略并从服务协定中删除。 如果缺少此标志,则当指定的接口包含一个或多个不兼容的方法时,该工具将不会生成服务配置。 |
例子
DESCRIPTION
以下示例使用 COM+ 托管模式将 OnlineStore COM+ 应用程序的 IFinances
接口 ItemOrders.IFinancial
集添加到作为 Web 服务公开的接口集。 除遇到的任何错误外还将输出所有警告。
代码
ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus /verbose
DESCRIPTION
以下示例使用 Web 托管模式,将 "IStockLevels
" 组件(来自 "OnlineWarehouse COM+ 应用程序")的 ItemInventory.Warehouse
接口添加到公开为 Web 服务的接口集中。 Web 服务托管在 IIS 的 OnlineWarehouse 虚拟目录中。
代码
ComSvcConfig.exe /install /application:OnlineWarehouse /contract:ItemInventory.Warehouse,IStockLevels /hosting:was /webDirectory:root/OnlineWarehouse
DESCRIPTION
下面的示例从作为 Web 服务公开的接口集中移除 IFinances
组件(来自 OnlineStore COM+ 应用程序)的 ItemOrders.Financial
接口。
代码
ComSvcConfig.exe /uninstall /application:OnlineStore /interface:ItemOrders.Financial,IFinances /hosting:complus
DESCRIPTION
以下示例列出了当前公开的 COM+ 托管接口,以及本地计算机上的 OnlineStore COM+ 应用程序的相应地址和绑定详细信息。
代码
ComSvcConfig.exe /list /application:OnlineStore /hosting:complus