Udostępnij za pośrednictwem

Instrukcje: Używanie narzędzia konfiguracji modelu usług COM+

  • Artykuł

Po wybraniu odpowiedniego trybu hostingu użyj narzędzia wiersza polecenia COM+ Service Model Configuration (ComSvcConfig.exe), aby skonfigurować interfejsy aplikacji, które będą widoczne jako usługi sieci Web.

Uwaga

Aby wykonać dowolne z następujących zadań, musisz być administratorem na maszynie.

W przypadku korzystania z ComSvcConfig.exe na maszynie z systemem Windows 7 w celu skonfigurowania usługi internetowej do korzystania z najnowszej wersji modelu usługi (obecnie w wersji 4.5) wykonaj następujące kroki:

  1. Ustaw klucz [HKEY_LOCAL_COMPUTER\SOFTWARE\Microsoft\.NETFramework]\OnlyUseLatestCLR rejestru na wartość DWORD 0x00000001

  2. Uruchamianie comsvcconfig.exe

  3. Przywróć klucz rejestru dodany w kroku 1 z powrotem do oryginalnej wartości lub usuń go, jeśli nie istnieje.

Ważne

Przywrócenie tego klucza rejestru jest ważne. Jest to klucz zgodności. Nie można przywrócić tej zmiany może powodować problemy z innymi aplikacjami platformy .NET uruchomionymi na maszynie).

Ostrzeżenie

W przypadku korzystania z ComSvcConfig.exe /install na komputerze z systemem Windows 8 zostanie wyświetlone okno dialogowe z informacją "Aplikacja na komputerze wymaga następującej funkcji systemu Windows: .NET Framework 3.5 (w tym .NET 2.0 i .NET 3.0", jeśli program .NET Framework 3.5 nie jest zainstalowany. To okno dialogowe może być ignorowane. Alternatywnie można połączyć klucz rejestru OnlyUseLatestCLR z wartością DWORD 0x00000001

Dodawanie interfejsu przy użyciu trybu hostingu COM+

  • Uruchom polecenie ComSvcConfig przy użyciu opcji /install i /hosting:complus , jak pokazano w poniższym przykładzie.

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

    Polecenie dodaje IFinances interfejs ItemOrders.IFinancial składnika (z aplikacji Com+ sklepu OnlineStore) do zestawu interfejsów, które zostaną uwidocznione jako usługi sieci Web. Usługa korzysta z trybu hostingu COM+ i dlatego wymaga jawnej aktywacji aplikacji.

    Symbol wieloznaczny gwiazdki (*) może być używany dla składnika i interfejsu, ale należy unikać używania go, ponieważ może być konieczne uwidocznienie tylko wybranych funkcji jako usługi sieci Web. W przypadku uruchomienia z przyszłą wersją tego składnika użycie symbolu wieloznakowego może przypadkowo uwidaczniać interfejsy, które mogły nie być obecne podczas określania składni konfiguracji.

    /verbose opcja instruuje narzędzie do wyświetlania ostrzeżeń oprócz błędów.

    Kontrakt dla uwidocznionej usługi będzie zawierać wszystkie metody z interfejsu IFinances .

Dodawanie określonych metod z interfejsu przy użyciu trybu hostingu COM+

  • Uruchom polecenie ComSvcConfig przy użyciu /install opcji i /hosting:complus z jawnym nazewnictwem wymaganych metod, jak pokazano w poniższym przykładzie.

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

    Polecenie dodaje tylko Credit metody i Debit z interfejsu IFinances jako operacje do uwidocznionego kontraktu usługi. Wszystkie inne metody interfejsu zostaną pominięte z kontraktu i nie będą wywoływane z klientów usługi sieci Web.

Dodawanie interfejsu przy użyciu trybu hostingu sieci Web

  • Uruchom polecenie ComSvcConfig przy użyciu /install opcji i /hosting:was opcji, jak pokazano w poniższym przykładzie.

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

    Polecenie dodaje IStockLevels interfejs w składniku ItemInventory.Warehouse (z aplikacji COM+ OnlineWarehouse) do zestawu interfejsów, które będą widoczne jako usługi sieci Web. Usługa jest hostowana w sieci Web w katalogu wirtualnym usługi OnlineWarehouse usług IIS, a nie w modelu COM+, a tym samym aplikacja jest automatycznie aktywowana zgodnie z potrzebami.

    Aby korzystać z konfiguracji hostowanej w procesie sieci Web, aplikacja COM+ musi być skonfigurowana do uruchamiania jako aplikacja biblioteka, a nie aplikacja serwera przy użyciu konsoli administracyjnej usług składników. Aplikacje skonfigurowane jako aplikacje serwera używają standardowego trybu hostowanego w sieci Web i powodują przeskok procesu w celu przetworzenia każdego żądania.

    Opcja /mex dodaje dodatkowy punkt końcowy usługi Wymiany metadanych (MEX), który używa tego samego transportu co punkt końcowy usługi aplikacji do obsługi klientów, którzy chcą pobrać definicję kontraktu z usługi.

Usuwanie usługi sieci Web dla określonego interfejsu

  • Uruchom polecenie ComSvcConfig przy użyciu /uninstall opcji , jak pokazano w poniższym przykładzie.

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

    Polecenie usuwa IFinances interfejs składnika ItemOrders.Financial (z aplikacji COM+ OnlineStore).

Wyświetlanie listy obecnie uwidocznionych interfejsów

  • Uruchom polecenie ComSvcConfig przy użyciu /list opcji , jak pokazano w poniższym przykładzie.

    ComSvcConfig.exe /list

    Polecenie wyświetla listę obecnie uwidocznionych interfejsów wraz z odpowiednimi adresami i szczegółami powiązania określonymi w zakresie komputera lokalnego.

Wyświetlanie listy aktualnie uwidocznionych interfejsów

  • Uruchom polecenie ComSvcConfig przy użyciu /list opcji , jak pokazano w poniższym przykładzie.

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

    Polecenie wyświetla obecnie uwidocznione interfejsy COM+-hosted wraz z odpowiednimi adresami i szczegółami powiązania aplikacji OnlineStore COM+ na komputerze lokalnym.

Wyświetlanie pomocy dotyczącej opcji

  • Uruchom polecenie ComSvcConfig przy użyciu /? opcja, jak pokazano w poniższym przykładzie.

    ComSvcConfig.exe /?

Zobacz też