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

Nachdem Sie einen geeigneten Hosting-Modus ausgewählt haben, verwenden Sie das COM+-Dienstmodell-Konfigurations-Befehlszeilentool (ComSvcConfig.exe) zur Konfigurierung der Anwendungsschnittstellen, die als Webdienste verfügbar gemacht werden.Once you have selected an appropriate hosting mode, use the COM+ Service Model Configuration command-line tool (ComSvcConfig.exe) to configure the application interfaces that will be exposed as Web services.

Hinweis

Sie müssen über Administratorrechte verfügen, um die folgenden Aufgaben auszuführen zu können.You must be an administrator on the machine to perform any of the following tasks.

Wenn Sie ComSvcConfig.exe auf einem Windows 7-Computer verwenden, um einen Webdienst für die Verwendung der neuesten Dienstmodellversion (derzeit 4.5) zu konfigurieren, führen Sie folgende Schritte aus:When using ComSvcConfig.exe on a Windows 7 machine to configure a web service to use the latest service model version (currently v4.5), perform the following steps:

  1. Legen Sie den Registrierungsschlüssel [HKEY_LOCAL_COMPUTER\SOFTWARE\Microsoft\.NETFramework]\OnlyUseLatestCLR auf einen DWORD-Wert von 0 x 00000001Set the registry key [HKEY_LOCAL_COMPUTER\SOFTWARE\Microsoft\.NETFramework]\OnlyUseLatestCLR to a DWORD value of 0x00000001

  2. Führen Sie comsvcconfig.exe aus.Run comsvcconfig.exe

  3. Legen Sie den in Schritt 1 festgelegten Registrierungsschlüssel wieder auf den ursprünglichen Wert fest, oder löschen Sie ihn, wenn er nicht vorhanden war.Revert the registry key added in step 1 back to its original value, or delete it if did not exist.

Wichtig

Es ist wichtig, diesen Registrierungsschlüssel wieder zurückzuversetzen, weil er einenReverting this registry key is important. Kompatibilitätsschlüssel darstellt.This is a compatibility key. Wird diese Änderung nicht rückgängig gemacht, können Probleme mit anderen .NET-Anwendungen auftreten, die auf dem Computer ausgeführt werden).Not reverting this change may cause issues with other .NET applications running on the machine).

Warnung

Bei Verwendung von ComSvcConfig.exe/install auf einem Windows 8-Computer ein Dialogfeld wird angezeigt, "eine app auf Ihrem PC benötigt die folgenden Windows-Funktion: .NET Framework 3.5 (umfasst .NET 2.0 und .NET 3.0", wenn .NET Framework 3.5 nicht installiert ist.When using ComSvcConfig.exe /install on a Windows 8 machine a dialog is displayed stating "An app on your PC needs the following Windows feature: .NET Framework 3.5 (includes .NET 2.0 and .NET 3.0" if .NET Framework 3.5 is not installed. Dieses Dialogfeld kann ignoriert werden.This dialog may be ignored. Alternativ können Sie den OnlyUseLatestCLR-Registrierungsschlüssel auf den DWORD-Wert 0x00000001 festlegen.Alternatively you can sed the OnlyUseLatestCLR registry key to a DWORD value of 0x00000001

Um mithilfe des COM+-Hostingmodus eine Schnittstelle zu der Gruppe von Schnittstellen hinzuzufügen, die als Webdienste verfügbar gemacht werden sollen.To add an interface to the set of interfaces that are to be exposed as Web services, using the COM+ hosting mode

  • Führen Sie ComSvcConfig mithilfe der /install- und der /hosting:complus-Optionen aus, wie im folgenden Beispiel gezeigt.Run ComSvcConfig using the /install and /hosting:complus options, as shown in the following example.

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

    Der Befehl fügt die IFinances-Schnittstelle der ItemOrders.IFinancial-Komponente (aus der OnlineStore-COM+-Anwendung) zu der Gruppe von Schnittstellen hinzu, die als Webdienste verfügbar gemacht werden.The command adds the IFinances interface of the ItemOrders.IFinancial component (from the OnlineStore COM+ application) to the set of interfaces that will be exposed as Web services. Der Dienst verwendet den COM+-Hostingmodus und erfordert deshalb eine explizite Anwendungsaktivierung.The service uses the COM+ hosting mode and therefore requires explicit application activation.

    Obwohl das Sternchenzeichen (*) als Platzhalter für die Komponente und die Schnittstelle verwendet werden kann, sollten Sie es vermeiden, da Sie möglicherweise nur ausgewählte Funktionen als Webdienst verfügbar machen möchten.While the wildcard asterisk (*) character can be used for the component and the interface, avoid using it because you might want to expose only selected functionality as a Web service. Bei der Ausführung mit einer künftigen Version dieser Komponente kann die Verwendung des Platzhalters unbeabsichtigt Schnittstellen verfügbar machen, die noch nicht vorhanden waren, als die Konfigurationssyntax festgelegt wurde.If run with a future version of this component, using the wildcard may unintentionally expose interfaces that may not have been present when the configuration syntax was determined.

    Die Option für die ausführliche Ausgabe weist das Tool an, zusätzlich zu Fehlern Warnungen anzuzeigen.The /verbose option instructs the tool to display warnings in addition to any errors.

    Der Vertrag für den verfügbar gemachten Dienst enthält alle Methoden aus der IFinances-Schnittstelle.The contract for the exposed service will contain all of the methods from the IFinances interface.

So fügen Sie der Gruppe von Schnittstellen, die als Webdienste verfügbar gemacht werden sollen, nur bestimmte Methoden einer Schnittstelle mithilfe des COM+-Hostingmodus hinzuTo add only specific methods from an interface to the set of interfaces that are to be exposed as Web services, using the COM+ hosting mode

  • Führen Sie ComSvcConfig mithilfe der /install- und der /hosting:complus-Optionen mit expliziter Benennung der erforderlichen Methoden aus, wie im folgenden Beispiel gezeigt.Run ComSvcConfig using the /install and /hosting:complus options with explicit naming of the required methods, as shown in the following example.

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

    Der Befehl fügt nur die Credit- und die Debit-Methode der IFinances-Schnittstelle als Vorgänge zu dem verfügbar gemachten Dienstvertrag hinzu.The command adds only the Credit and Debit methods from the IFinances interface as operations to the exposed service contract. Alle anderen Methoden der Schnittstelle erscheinen nicht im Vertrag und können von Webdienstclients nicht aufgerufen werden.All other methods on the interface will be omitted from the contract and will not be callable from Web service clients.

So fügen Sie einer Gruppe von Schnittstellen, die als Webdienste verfügbar gemacht werden sollen, eine Schnittstelle mithilfe des Webhostingmodus hinzuTo add an interface to the set of interfaces that are to be exposed as Web services, using the Web hosting mode

  • Führen Sie ComSvcConfig mithilfe der /install- und der /hosting:was-Option aus, wie im folgenden Beispiel gezeigt.Run ComSvcConfig using the /install option and the /hosting:was option, as shown in the following example.

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

    Der Befehl fügt die IStockLevels-Schnittstelle der ItemInventory.Warehouse-Komponente (aus der OnlineWarehouse-COM+-Anwendung) zu der Gruppe von Schnittstellen hinzu, die als Webdienste verfügbar gemacht werden.The command adds the IStockLevels interface on the ItemInventory.Warehouse component (from the OnlineWarehouse COM+ application) to the set of interfaces that will be exposed as Web services. Statt in COM+ wird der Dienst im virtuellen OnlineWarehouse-Verzeichnis von IIS im Internet gehostet, und folglich wird die Anwendung automatisch bei Bedarf aktiviert.The service is Web hosted in the OnlineWarehouse virtual directory of IIS rather than in COM+, and thus the application is automatically activated as required.

    Um die im Internet gehostete prozessinterne Konfiguration zu verwenden, muss die COM+-Anwendung mithilfe der Verwaltungskonsole Komponentendienste so konfiguriert werden, dass sie als Library-Anwendung ausgeführt wird.To use the Web-hosted in-process configuration, the COM+ application must be configured to run as a Library application rather than a Server application using the Component Services administration console. Anwendungen, die als Serveranwendungen konfiguriert werden, werden standardmäßig im Internet gehostet und bewirken einen Prozesshop für die Verarbeitung jeder Anforderung.Applications configured as Server applications use the standard Web-hosted mode and incur a process hop to process each request.

    Die /mex-Option fügt einen zusätzlichen Metadatenaustausch-Dienstendpunkt (MEX oder Metadata Exchange) hinzu, der denselben Transport verwendet wie der Dienstendpunkt der Anwendung, um Clients beim Abrufen einer Vertragsdefinition vom Dienst zu unterstützen.The /mex option adds an additional Metadata Exchange (MEX) service endpoint that uses the same transport as the application's service endpoint to support clients that want to retrieve a contract definition from the service.

Entfernen eines Webdiensts aus einer angegebenen SchnittstelleTo remove a Web service for a specified interface

  • Führen Sie ComSvcConfig mithilfe der /uninstall-Optionen aus, wie im folgenden Beispiel gezeigt:Run ComSvcConfig using the /uninstall option, as shown in the following example.

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

    Der Befehl entfernt die IFinances-Schnittstelle in der ItemOrders.Financial-Komponente (aus der OnlineStore-COM+-Anwendung).The command removes the IFinances interface on the ItemOrders.Financial component (from the OnlineStore COM+ application).

So listen Sie zurzeit verfügbare Schnittstellen aufTo list currently exposed interfaces

  • Führen Sie ComSvcConfig mithilfe der /list-Optionen aus, wie im folgenden Beispiel gezeigt:Run ComSvcConfig using the /list option, as shown in the following example.

    ComSvcConfig.exe /list  
    

    Der Befehl listet die derzeit verfügbaren Schnittstellen zusammen mit den entsprechenden Adress- und Bindungsdetails auf, deren Gültigkeitsbereich der lokale Computer ist.The command lists the currently exposed interfaces, along with the corresponding address and binding details, scoped to the local machine.

So listen Sie bestimmte zurzeit verfügbare Schnittstellen aufTo list specific currently exposed interfaces

  • Führen Sie ComSvcConfig mithilfe der /list-Optionen aus, wie im folgenden Beispiel gezeigt:Run ComSvcConfig using the /list option, as shown in the following example.

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

    Der Befehl listet derzeit verfügbare COM+-gehostete Schnittstellen zusammen mit den entsprechenden Adress- und Bindungsdetails für die OnlineStore-COM+-Anwendung auf dem lokalen Computer auf.The command lists currently exposed COM+-hosted interfaces, along with the corresponding address and binding details, for the OnlineStore COM+ application on the local machine.

So zeigen Sie Hilfe in den Optionen an, die mit dem Hilfsprogramm verwendet werden könnenTo display help on the options that can be used with the utility

  • Führen Sie ComSvcConfig mithilfe der /?Run ComSvcConfig using the /? -Option aus, wie im folgenden Beispiel gezeigt.option, as shown in the following example.

    ComSvcConfig.exe /?  
    

Siehe auchSee Also

Übersicht über die Integration von COM+-AnwendungenIntegrating with COM+ Applications Overview