COM+ 服务模型配置工具 (ComSvcConfig.exe)

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  

另请参阅