COM+ Service Model Configuration-Tool (ComSvcConfig.exe)COM+ Service Model Configuration Tool (ComSvcConfig.exe)

Das Befehlszeilentool COM+ Service Model Configuration (ComSvcConfig.exe) ermöglicht die Konfiguration von COM+-Schnittstellen, die als Webdienste verfügbar gemacht werden sollen.The COM+ Service Model Configuration command-line tool (ComSvcConfig.exe) enables you to configure COM+ interfaces to be exposed as Web services.

SyntaxSyntax

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]  

HinweiseRemarks

Hinweis

Sie müssen Administrator auf dem lokalen Computer sein, um ComSvcConfig.exe zu verwenden.You must be an administrator on the local computer to use ComSvcConfig.exe.

Das Tool befindet sich an folgendem Speicherort:The tool can be found in the following location

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

Weitere Informationen zu ComSvcConfig.exe, finden Sie unter Vorgehensweise: Verwenden Sie das COM+ Service Model Configuration-Tool.For more information about ComSvcConfig.exe, see How to: Use the COM+ Service Model Configuration Tool.

In der folgenden Tabelle werden die Modi beschrieben, die mit ComSvcConfig.exe verwendet werden können.The following table describes the modes that can be used with ComSvcConfig.exe.

OptionOption BeschreibungDescription
install Installiert eine Konfiguration für eine COM+-Schnittstelle für die Service Model-Integration.Installs a configuration for a COM+ interface for Service Model integration.

Kurzform: /i.Short form /i.
uninstall Deinstalliert eine Konfiguration für eine COM+-Schnittstelle aus der Service Model-Integration.Uninstalls a configuration for a COM+ interface from Service Model integration.

Kurzform: /u.Short form /u.
list Listet Informationen über COM+-Anwendungen und -Komponenten auf, die über Schnittstellen verfügen, die für die Service Model-Integration konfiguriert sind.Lists information about COM+ applications and components that have interfaces that are configured for Service Model integration.

Kurzform: /l.Short form /l.

In der folgenden Tabelle werden die Flags beschrieben, die mit ComSvcConfig.exe verwendet werden können.The following table describes the flags that can be used with ComSvcConfig.exe.

OptionOption BeschreibungDescription
/application: <ApplicationID | Parameter "ApplicationName">/application: <ApplicationID | ApplicationName> Gibt die zu konfigurierende COM+-Anwendung an.Specifies the COM+ application to configure.

Kurzform: /a.Short form /a.
/contract: <ClassID | ProgID | *,InterfaceID | Schnittstellenname | *>/contract: <ClassID | ProgID | *,InterfaceID | InterfaceName | *> Gibt die COM+-Komponente und -Schnittstelle an, die als Vertrag für den Dienst konfiguriert werden sollen.Specifies the COM+ component and interface that will be configured as the contract for the service.

Kurzform: /c.Short form /c.

Während Sie das Platzhalterzeichen (*) kann verwendet werden, wenn Sie angeben, dass die Namen Komponenten- und Schnittstellennamen es wird empfohlen, dass Sie ihn nicht verwenden, da Sie Schnittstellen verfügbar, die Sie nicht zum beabsichtigten machen können.While the wildcard character (*) can be used when you specify the component and interface names, we recommend that you do not use it, because you might expose interfaces that you did not intend to.
/hosting: <ComPlus | wurde >/hosting: <complus | was> Gibt an, ob der COM+-Hostingmodus oder der Webhostingmodus verwendet werden soll.Specifies whether to use the COM+ hosting mode or the Web hosting mode.

Kurzform: /h.Short form /h.

Die Verwendung des COM+-Hostingmodus erfordert die explizite Aktivierung der COM+-Anwendung.Using the COM+ hosting mode requires explicit activation of the COM+ application. Bei der Verwendung des Webhostingmodus wird die COM+-Anwendung automatisch aktiviert.Using the Web hosting mode allows the COM+ application to be automatically activated as required. Wenn die COM+-Anwendung eine Bibliotheksanwendung ist, wird sie im IIS-Prozess (Internetinformationsdienste) ausgeführt.If the COM+ application is a library application, it runs in the Internet Information Services (IIS) process. Wenn die COM+-Anwendung eine Serveranwendung ist, wird sie im Dllhost.exe-Prozess ausgeführt.If the COM+ application is a server application, it runs in the Dllhost.exe process.
/webSite: <WebsiteName>/webSite: <WebsiteName> Gibt bei Verwendung des Webhostingmodus die Website für das Hosting an (siehe das /hosting-Flag).Specifies the Web site for hosting when Web hosting mode is used (see the /hosting flag).

Kurzform: /w.Short form /w.

Wenn keine Website angegeben wird, wird die Standardwebsite verwendet.If no Web site is specified, the default Web site is used.
/webDirectory: <WebDirectoryName>/webDirectory: <WebDirectoryName> Gibt bei Verwendung des Webhosting das virtuelle Hostingverzeichnis an (siehe das /hosting-Flag).Specifies the virtual directory for hosting when Web hosting is used (see the /hosting flag).

Kurzform: /d.Short form /d.
/mex Fügt der Standarddienstkonfiguration einen MEX-Dienstendpunkt (Metadata Exchange, Metadatenaustausch) hinzu, um Clients zu unterstützen, die eine Vertragsdefinition vom Dienst abrufen.Adds a Metadata Exchange (MEX) service endpoint to the default service configuration to support clients that want to retrieve a contract definition from the service.

Kurzform: /x.Short form /x.
/id Zeigt die Anwendungs-, Komponenten- und Schnittstelleninformationen als IDs an.Displays the application, component, and interface information as IDs.

Kurzform: /k.Short form /k.
/nologo Verhindert, dass ComSvcConfig.exe sein Logo anzeigt.Prevents ComSvcConfig.exe from displaying its logo.

Kurzform: /n.Short form /n.
/verbose Gibt alle Warnungen oder Informationsmeldungen zusätzlich zu gefundenen Fehlern aus.Outputs all warnings or informational text in addition to any errors encountered.

Kurzform: /v.Short form /v.
/help Zeigt die Syntaxmeldung an.Displays the usage message.

Kurzform: /?.Short form /?.
/partial Generiert eine Dienstkonfiguration, wenn die angegebene Schnittstelle ein oder mehr Methodensignaturen umfasst, die verfügbar gemacht werden können.Generates a service configuration when the specified interface includes one or more method signatures that can be exposed. Zum Zeitpunkt der Dienstinitialisierung werden kompatible Methoden als Vorgänge für den Dienstvertrag angezeigt, und nicht kompatible Methoden werden ignoriert und gelten als nicht vorhanden für den Dienstvertrag.At service initialization time, compatible methods appear as operations on the service contract, and non-compatible methods are ignored and absent from the service contract.

Fehlt das Flag, generiert das Tool keine Dienstkonfiguration, wenn die angegebene Schnittstelle ein oder mehr inkompatible Methoden umfasst.If this flag is missing, the tool will not generate a service configuration when the specified interface includes one or more incompatible methods.

BeispieleExamples

BeschreibungDescription

Im folgenden Beispiel wird die IFinances-Schnittstelle der ItemOrders.IFinancial-Komponente (aus der OnlineStore-COM+-Anwendung) mithilfe des COM+-Hostingmodus der Gruppe von Schnittstellen hinzugefügt, die als Webdienste verfügbar gemacht werden sollen.The following example adds the IFinances interface of the ItemOrders.IFinancial component (from the OnlineStore COM+ application) to the set of interfaces that are exposed as Web services, using the COM+ hosting mode. Alle Warnungen werden zusätzlich zu gefundenen Fehlern ausgegeben.All warnings will be output in addition to any errors encountered.

CodeCode

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

BeschreibungDescription

Im folgenden Beispiel wird die IStockLevels-Schnittstelle der ItemInventory.Warehouse-Komponente (aus der OnlineWarehouse-COM+-Anwendung) mithilfe des Webhostingmodus der Gruppe von Schnittstellen hinzugefügt, die als Webdienste verfügbar gemacht werden sollen.The following example adds the IStockLevels interface of the ItemInventory.Warehouse component (from the OnlineWarehouse COM+ application) to the set of interfaces that are exposed as Web services, using the Web hosting mode. Der Webdienst wird im virtuellen IIS-Verzeichnis OnlineWarehouse gehostet.The Web service is Web hosted in the OnlineWarehouse virtual directory of IIS.

CodeCode

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

BeschreibungDescription

Im folgenden Beispiel wird die IFinances-Schnittstelle der ItemOrders.Financial-Komponente (aus der OnlineStore-COM+-Anwendung) aus der Gruppe von Schnittstellen entfernt, die als Webdienste verfügbar gemacht werden.The following example removes the IFinances interface of the ItemOrders.Financial component (from the OnlineStore COM+ application) from the set of interfaces that are exposed as Web services.

CodeCode

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

BeschreibungDescription

Im folgenden Beispiel werden die derzeit verfügbar gemachten COM+-gehosteten Schnittstellen zusammen mit den entsprechenden Adress- und Bindungsdetails für die OnlineStore-COM+-Anwendung auf dem lokalen Computer aufgelistet.The following example lists currently exposed COM+ hosted interfaces, along with the corresponding address and binding details, for the OnlineStore COM+ application on the local machine.

CodeCode

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

Siehe auchSee Also

Vorgehensweise: Verwenden des COM+-Dienstmodell-KonfigurationstoolsHow to: Use the COM+ Service Model Configuration Tool