共用方式為


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搭配使用的模式。

選項 說明
install 安裝 COM+ 介面的組態以進行服務模型整合。

簡短格式 /i
uninstall 從服務模型整合卸載 COM+ 介面的設定。

簡短格式 /u
list 列出 COM+ 應用程式和元件的相關信息,這些元件具有針對服務模型整合所設定的介面。

簡短格式 /l

下表描述可與 ComSvcConfig.exe搭配使用的旗標。

選項 說明
/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 將元數據 Exchange (MEX) 服務端點新增至預設服務組態,以支援想要從服務擷取合約定義的用戶端。

簡短格式 /x
/id 將應用程式、元件和介面信息顯示為標識碼。

簡短格式 /k
/nologo 防止 ComSvcConfig.exe 顯示其標誌。

簡短格式 /n
/verbose 除了遇到的任何錯誤之外,還輸出所有警告或資訊文字。

簡短格式 /v
/help 顯示使用方式訊息。

簡短格式 /?
/partial 當指定的介面包含一或多個可公開的方法簽章時,產生服務組態。 在服務初始化階段,相容的方法會顯示為服務合約上的作業,且服務合約中會忽略與不存在不相容的方法。

如果遺漏此旗標,當指定的介面包含一或多個不相容的方法時,此工具將不會產生服務組態。

範例

說明

下列範例使用 COM+ 裝載模式,將 OnlineStore COM+ 應用程式的元件IFinances介面新增到一組介面中,並作為 Web 服務公開。 系統將輸出所有警告,以及可能發生的任何錯誤。

程式碼

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

說明

以下範例會使用 Web 裝載模式,將來自 OnlineWarehouse COM+ 應用程式的 IStockLevels 元件的 ItemInventory.Warehouse 介面新增到公開為網頁服務的介面集合中。 Web 服務是裝載在 IIS OnlineWarehouse 虛擬目錄中的 Web。

程式碼

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

說明

下列範例將從 OnlineStore COM+ 應用程式的介面集合中移除 IFinances 元件的 ItemOrders.Financial 介面,以免其被公開為 Web 服務。

程式碼

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

說明

下列範例會列出本機計算機上 OnlineStore COM+ 應用程式的目前公開 COM+ 裝載介面,以及對應的位址和系結詳細數據。

程式碼

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

另請參閱