共用方式為


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  

另請參閱