Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Mit dem Befehlszeilentool COM+ Service Model Configuration (ComSvcConfig.exe) können Sie COM+-Schnittstellen so konfigurieren, dass sie als Webdienste verfügbar gemacht werden.
Syntax
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]
Bemerkungen
Hinweis
Sie müssen ein Administrator auf dem lokalen Computer sein, um ComSvcConfig.exezu verwenden.
Das Tool befindet sich an der folgenden Stelle.
%SystemRoot%\Microsoft.Net\Framework\v3.0\Windows Communication Foundation\
Weitere Informationen zu ComSvcConfig.exefinden Sie unter How to: Use the COM+ Service Model Configuration Tool.
In der folgenden Tabelle werden die Modi beschrieben, die mit ComSvcConfig.exeverwendet werden können.
| Auswahlmöglichkeit | BESCHREIBUNG |
|---|---|
install |
Installiert eine Konfiguration für eine COM+-Schnittstelle für die Integration des Dienstmodells. Kurzform /i. |
uninstall |
Deinstalliert eine Konfiguration für eine COM+-Schnittstelle aus der Dienstmodellintegration. Kurzform /u. |
list |
Listet Informationen zu COM+-Anwendungen und -Komponenten auf, die Schnittstellen enthalten, die für die Integration des Dienstmodells konfiguriert sind. Kurzform /l. |
In der folgenden Tabelle werden die Flags beschrieben, die mit ComSvcConfig.exeverwendet werden können.
| Auswahlmöglichkeit | BESCHREIBUNG |
|---|---|
/application:
<
ApplicationID | ApplicationName> |
Gibt die zu konfigurierende COM+-Anwendung an. Kurzform /a. |
/contract:
<
ClassID | ProgID | *,InterfaceID | InterfaceName | *> |
Gibt die COM+-Komponente und schnittstelle an, die als Vertrag für den Dienst konfiguriert wird. Kurzform /c.Während das Platzhalterzeichen (*) verwendet werden kann, wenn Sie die Komponenten- und Schnittstellennamen angeben, wird empfohlen, sie nicht zu verwenden, da Sie möglicherweise Schnittstellen verfügbar machen, die Sie nicht beabsichtigt haben. |
/hosting:
<
complus | war> |
Gibt an, ob der COM+-Hostingmodus oder der Webhostingmodus verwendet werden soll. Kurzform /h.Die Verwendung des COM+-Hostingmodus erfordert eine explizite Aktivierung der COM+-Anwendung. Mit dem Webhostingmodus kann die COM+-Anwendung bei Bedarf automatisch aktiviert werden. Wenn es sich bei der COM+-Anwendung um eine Bibliotheksanwendung handelt, wird sie im IIS-Prozess (Internet Information Services) ausgeführt. Wenn es sich bei der COM+-Anwendung um eine Serveranwendung handelt, wird sie im Dllhost.exe Prozess ausgeführt. |
/webSite:
<
WebsiteName> |
Gibt die Website für das Hosting an, wenn der Webhostingmodus verwendet wird (siehe /hosting Flagge).Kurzform /w.Wenn keine Website angegeben ist, wird die Standardwebsite verwendet. |
/webDirectory:
<
WebDirectoryName> |
Gibt das virtuelle Verzeichnis für das Hosting an, wenn Webhosting verwendet wird (siehe /hosting Flag).Kurzform /d. |
/mex |
Fügt der Standarddienstkonfiguration einen Metadaten-Exchange-Dienstendpunkt (Metadata Exchange, MEX) hinzu, um Clients zu unterstützen, die eine Vertragsdefinition vom Dienst abrufen möchten. Kurzform /x. |
/id |
Zeigt die Anwendungs-, Komponenten- und Schnittstelleninformationen als IDs an. Kurzform /k. |
/nologo |
Verhindert, dass ComSvcConfig.exe sein Logo anzeigt. Kurzform /n. |
/verbose |
Gibt zusätzlich zu allen aufgetretenen Fehlern alle Warnungen oder Informationstexte aus. Kurzform /v. |
/help |
Zeigt die Verwendungsmeldung an. Kurzform /?. |
/partial |
Generiert eine Dienstkonfiguration, wenn die angegebene Schnittstelle eine oder mehrere Methodensignaturen enthält, die verfügbar gemacht werden können. Bei der Dienstinitialisierung werden kompatible Methoden als Vorgänge im Dienstvertrag angezeigt, und nicht kompatible Methoden werden ignoriert und fehlen im Dienstvertrag. Wenn dieses Flag fehlt, generiert das Tool keine Dienstkonfiguration, wenn die angegebene Schnittstelle eine oder mehrere inkompatible Methoden enthält. |
Beispiele
BESCHREIBUNG
Im folgenden Beispiel wird die IFinances Schnittstelle der ItemOrders.IFinancial Komponente (aus der OnlineStore-COM+-Anwendung) zu den Schnittstellen hinzugefügt, die als Webdienste verfügbar gemacht werden, wobei der COM+-Hostingmodus verwendet wird. Alle Warnungen werden zusätzlich zu allen aufgetretenen Fehlern ausgegeben.
Programmcode
ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus /verbose
BESCHREIBUNG
Im folgenden Beispiel wird die IStockLevels Schnittstelle der ItemInventory.Warehouse Komponente (aus der OnlineWarehouse-COM+-Anwendung) zu den Schnittstellen hinzugefügt, die als Webdienste verfügbar gemacht werden, wobei der Webhostingmodus verwendet wird. Der Webdienst wird im virtuellen OnlineWarehouse-Verzeichnis von IIS gehostet.
Programmcode
ComSvcConfig.exe /install /application:OnlineWarehouse /contract:ItemInventory.Warehouse,IStockLevels /hosting:was /webDirectory:root/OnlineWarehouse
BESCHREIBUNG
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.
Programmcode
ComSvcConfig.exe /uninstall /application:OnlineStore /interface:ItemOrders.Financial,IFinances /hosting:complus
BESCHREIBUNG
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.
Programmcode
ComSvcConfig.exe /list /application:OnlineStore /hosting:complus