Narzędzie konfiguracji modelu usług COM+ (ComSvcConfig.exe)
Narzędzie wiersza polecenia COM+ Service Model Configuration (ComSvcConfig.exe) umożliwia skonfigurowanie interfejsów COM+ jako usług sieci Web.
Składnia
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]
Uwagi
Uwaga
Aby korzystać z ComSvcConfig.exe, musisz być administratorem na komputerze lokalnym.
Narzędzie można znaleźć w następującej lokalizacji
%SystemRoot%\Microsoft.Net\Framework\v3.0\Windows Communication Foundation\
Aby uzyskać więcej informacji na temat ComSvcConfig.exe, zobacz How to: Use the COM+ Service Model Configuration Tool (Instrukcje: korzystanie z narzędzia com+ Service Model Configuration Tool).
W poniższej tabeli opisano tryby, których można używać z ComSvcConfig.exe.
| Opcja | Opis |
|---|---|
install |
Instaluje konfigurację interfejsu COM+ na potrzeby integracji modelu usługi. Krótki formularz /i. |
uninstall |
Odinstalowuje konfigurację interfejsu COM+ z poziomu integracji modelu usługi. Krótki formularz /u. |
list |
Wyświetla informacje o aplikacjach i składnikach modelu COM+ z interfejsami skonfigurowanymi do integracji modelu usługi. Krótki formularz /l. |
W poniższej tabeli opisano flagi, których można używać z ComSvcConfig.exe.
| Opcja | Opis |
|---|---|
/application:<ApplicationID | ApplicationName> |
Określa aplikację COM+ do skonfigurowania. Krótki formularz /a. |
/contract:<ClassID ProgID | | *,InterfaceID | InterfaceName | *> |
Określa składnik COM+ i interfejs, który zostanie skonfigurowany jako kontrakt dla usługi. Krótki formularz /c.Chociaż symbol wieloznaczny (*) może być używany podczas określania nazw składników i interfejsów, zalecamy, aby go nie używać, ponieważ można uwidocznić interfejsy, których nie zamierzasz. |
/hosting:<complus | był> |
Określa, czy używać trybu hostingu COM+ czy trybu hostingu sieci Web. Krótki formularz /h.Korzystanie z trybu hostingu COM+ wymaga jawnej aktywacji aplikacji COM+. Użycie trybu hostingu sieci Web umożliwia automatyczne aktywowanie aplikacji COM+ zgodnie z potrzebami. Jeśli aplikacja COM+ jest aplikacją biblioteki, jest uruchamiana w procesie internetowych usług informacyjnych (IIS). Jeśli aplikacja COM+ jest aplikacją serwera, jest uruchamiana w procesie Dllhost.exe. |
/webSite:<Nazwa witryny sieci Web> |
Określa witrynę sieci Web do hostowania, gdy jest używany tryb hostingu sieci Web (zobacz flagę /hosting ).Krótki formularz /w.Jeśli nie określono żadnej witryny sieci Web, zostanie użyta domyślna witryna sieci Web. |
/webDirectory:<WebDirectoryName> |
Określa katalog wirtualny do hostowania, gdy jest używany hosting internetowy (zobacz flagę /hosting ).Krótki formularz /d. |
/mex |
Dodaje punkt końcowy usługi Wymiany metadanych (MEX) do domyślnej konfiguracji usługi w celu obsługi klientów, którzy chcą pobrać definicję kontraktu z usługi. Krótki formularz /x. |
/id |
Wyświetla informacje o aplikacji, składniku i interfejsie jako identyfikatory. Krótki formularz /k. |
/nologo |
Uniemożliwia ComSvcConfig.exe wyświetlania logo. Krótki formularz /n. |
/verbose |
Zwraca wszystkie ostrzeżenia lub tekst informacyjny oprócz napotkanych błędów. Krótki formularz /v. |
/help |
Wyświetla komunikat użycia. Krótki formularz /?. |
/partial |
Generuje konfigurację usługi, gdy określony interfejs zawiera co najmniej jeden podpis metody, który można uwidocznić. W czasie inicjowania usługi zgodne metody są wyświetlane jako operacje w umowie usługi, a metody niezgodne są ignorowane i nieobecne w umowie usługi. Jeśli brakuje tej flagi, narzędzie nie wygeneruje konfiguracji usługi, gdy określony interfejs zawiera co najmniej jedną niezgodną metodę. |
Przykłady
opis
Poniższy przykład dodaje IFinances interfejs ItemOrders.IFinancial składnika (z aplikacji COM+ OnlineStore) do zestawu interfejsów, które są uwidocznione jako usługi sieci Web, przy użyciu trybu hostingu COM+. Wszystkie ostrzeżenia będą wyświetlane oprócz wszystkich napotkanych błędów.
Kod
ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus /verbose
opis
Poniższy przykład dodaje IStockLevels interfejs ItemInventory.Warehouse składnika (z aplikacji COM+ OnlineWarehouse) do zestawu interfejsów uwidocznionych jako usługi sieci Web przy użyciu trybu hostingu sieci Web. Usługa sieci Web jest hostowana w katalogu wirtualnym usługi OnlineWarehouse usług IIS.
Kod
ComSvcConfig.exe /install /application:OnlineWarehouse /contract:ItemInventory.Warehouse,IStockLevels /hosting:was /webDirectory:root/OnlineWarehouse
opis
Poniższy przykład usuwa IFinances interfejs ItemOrders.Financial składnika (z aplikacji COM+ OnlineStore) z zestawu interfejsów, które są widoczne jako usługi sieci Web.
Kod
ComSvcConfig.exe /uninstall /application:OnlineStore /interface:ItemOrders.Financial,IFinances /hosting:complus
opis
W poniższym przykładzie wymieniono obecnie uwidocznione interfejsy com+ hostowane wraz z odpowiednimi szczegółami adresu i powiązania dla aplikacji Com+ sklepu OnlineStore na komputerze lokalnym.
Kod
ComSvcConfig.exe /list /application:OnlineStore /hosting:complus