COM+ 服務模型組態工具 (ComSvcConfig.exe)
COM+ 服務模型組態命令列工具 (ComSvcConfig.exe) 可讓您設定要公開為 Web 服務的 COM+ 介面。
語法
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:<應用程式識別碼 | 應用程式名稱> |
指定要設定的 COM+ 應用程式。 簡短形式： /a。 |
/contract:<類別識別碼 | 程式識別碼 | *,介面識別碼 | 介面名稱 | *> |
指定要設定為服務合約的 COM+ 元件和介面。 簡短形式： /c。雖然在指定元件和介面名稱時可以使用萬用字元 (*)，但是這麼做可能會公開您不想公開的介面，因此建議您不要使用萬用字元。 |
/hosting:<complus | was> |
指定使用 COM+ 主控模式或 Web 主控模式。 簡短形式： /h。使用 COM+ 主控模式必須明確啟動 COM+ 應用程式。 使用 Web 主控模式可讓 COM+ 應用程式視需要自動啟動。 如果 COM+ 應用程式是程式庫應用程式，它會在網際網路資訊服務 (IIS) 處理序中執行。 如果 COM+ 應用程式是伺服器應用程式，它會在 Dllhost.exe 處理序中執行。 |
/webSite:<網站名稱> |
指定使用 Web 主控模式時用於主控的網站 (請參閱 /hosting 旗標)。簡短形式： /w。如果未指定網站，則會使用預設網站。 |
/webDirectory:<網站目錄名稱> |
指定使用 Web 主控模式時用於主控的虛擬目錄 (請參閱 /hosting 旗標)。簡短形式： /d。 |
/mex |
將 Metadata Exchange (MEX) 服務端點新增至預設服務組態，以支援要從服務擷取合約定義的用戶端。 簡短形式： /x。 |
/id |
以 ID 的方式顯示應用程式、元件和介面資訊。 簡短形式： /k。 |
/nologo |
防止 ComSvcConfig.exe 顯示其標誌。 簡短形式： /n。 |
/verbose |
除了發生的任何錯誤之外，也輸出所有的警告或資訊文字。 簡短形式： /v。 |
/help |
顯示使用方式訊息。 簡短形式： /?。 |
/partial |
當指定的介面包含一或多個可公開的方法簽章時，產生服務組態。 在服務初始化階段，相容的方法會顯示為服務合約上的作業，不相容的方法會被忽略，且不會出現在服務合約中。 如果缺少這個旗標，當指定的介面包含一或多個不相容的方法時，工具不會產生服務組態。 |
範例
描述
下列範例說明使用 COM+ 主控模式，將 IFinances 元件的 (取自 OnlineStore COM+ 應用程式) ItemOrders.IFinancial 介面新增至公開為 Web 服務的介面組。 除了發生的任何錯誤之外，也輸出所有的警告訊息。
代碼
ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus /verbose
描述
下列範例說明使用 Web 主控模式，將 IStockLevels 元件的 (取自 OnlineWarehouse COM+ 應用程式) ItemInventory.Warehouse 介面新增至公開為 Web 服務的介面組。 Web 服務是由 IIS 的 OnlineWarehouse 虛擬目錄進行 Web 主控。
代碼
ComSvcConfig.exe /install /application:OnlineWarehouse /contract:ItemInventory.Warehouse,IStockLevels /hosting:was /webDirectory:root/OnlineWarehouse
描述
下列範例說明從公開為 Web 服務的介面組中移除 IFinances 元件的 (取自 OnlineStore COM+ 應用程式) ItemOrders.Financial 介面。
代碼
ComSvcConfig.exe /uninstall /application:OnlineStore /interface:ItemOrders.Financial,IFinances /hosting:complus
描述
下列範例列出本機電腦上 OnlineStore COM+ 應用程式目前公開的 COM+ 主控介面，以及對應的位址與繫結詳細資訊。
程式碼
ComSvcConfig.exe /list /application:OnlineStore /hosting:complus