共用方式為


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]

備註

ms732020.note(zh-tw,VS.100).gif注意:
您必須是本機電腦的系統管理員,才能使用 ComSvcConfig.exe。

您可以在下列位置找到這個工具

%SystemRoot%\Microsoft.Net\Framework\v3.0\Windows Communication Foundation\

如需 ComSvcConfig.exe 的詳細資訊,請參閱 HOW TO:使用 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 | was>

指定使用 COM+ 主控模式或 Web 主控模式。

簡短形式:/h

使用 COM+ 主控模式必須明確啟動 COM+ 應用程式。使用 Web 主控模式可讓 COM+ 應用程式視需要自動啟動。如果 COM+ 應用程式是程式庫應用程式,它會在網際網路資訊服務 (IIS) 處理序中執行。如果 COM+ 應用程式是伺服器應用程式,它會在 Dllhost.exe 處理序中執行。

/webSite:<WebsiteName>

指定使用 Web 主控模式時用於主控的網站 (請參閱 /hosting 旗標)。

簡短形式:/w

如果未指定網站,則會使用預設網站。

/webDirectory:<WebDirectoryName>

指定使用 Web 主控模式時用於主控的虛擬目錄 (請參閱 /hosting 旗標)。

簡短形式:/d

/mex

將 Metadata Exchange (MEX) 服務端點新增至預設服務組態,以支援要從服務擷取合約定義的用戶端。

簡短形式:/x

/id

以 ID 的方式顯示應用程式、元件和介面資訊。

簡短形式:/k

/nologo

防止 ComSvcConfig.exe 顯示其標誌。

簡短形式:/n

/verbose

除了發生的任何錯誤之外,也輸出所有的警告或資訊文字。

簡短形式:/v

/help

顯示使用方式訊息。

簡短形式:/?

/partial

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

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

範例

說明

下列範例說明使用 COM+ 主控模式,將 ItemOrders.IFinancial 元件的 (取自 OnlineStore COM+ 應用程式) IFinances 介面新增至公開為 Web 服務的介面組。除了發生的任何錯誤之外,也輸出所有的警告訊息。

程式碼

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

說明

下列範例說明使用 Web 主控模式,將 ItemInventory.Warehouse 元件的 (取自 OnlineWarehouse COM+ 應用程式) IStockLevels 介面新增至公開為 Web 服務的介面組。Web 服務是由 IIS 的 OnlineWarehouse 虛擬目錄進行 Web 主控。

程式碼

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

說明

下列範例說明從公開為 Web 服務的介面組中移除 ItemOrders.Financial 元件的 (取自 OnlineStore COM+ 應用程式) IFinances 介面。

程式碼

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

說明

下列範例列出本機電腦上 OnlineStore COM+ 應用程式目前公開的 COM+ 主控介面,以及對應的位址與繫結詳細資訊。

程式碼

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

另請參閱

工作

HOW TO:使用 COM+ 服務模型組態工具