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