Udostępnij za pośrednictwem

Procedura konfiguracji jednorazowej dla przykładów Windows Communication Foundation

  • Artykuł

Większość przykładów programu Windows Communication Foundation (WCF) jest hostowana w usługach Internet Information Services (IIS) i jest uruchamiana z wspólnego katalogu wirtualnego. Ta jednorazowa procedura instalacji tworzy folder na dysku; dodaje również katalog wirtualny do usług IIS o nazwie ServiceModelSamples.

Katalog wirtualny ServiceModelSamples służy do kompilowania i uruchamiania wszystkich przykładów korzystających z usługi hostowanej przez usługi IIS. Jest to jedyny katalog wirtualny, który jest wymagany do uruchomienia przykładów. Utworzenie przykładu spowoduje zastąpienie wszystkich wcześniej wdrożonych usług w tym katalogu wirtualnym; tylko ostatnio utworzony przykład zostanie wdrożony i dostępny w tym katalogu wirtualnym.

Uwaga

  • Wszystkie polecenia należy uruchomić na koncie administratora lokalnego. Jeśli używasz systemu Windows 7, Windows Vista lub Windows Server 2008 R2, musisz również uruchomić wiersz polecenia z podwyższonym poziomem uprawnień. W tym celu kliknij prawym przyciskiem myszy ikonę wiersza polecenia, a następnie kliknij polecenie Uruchom jako administrator.
  • Wszystkie polecenia w tym artykule muszą być uruchamiane w wierszu polecenia, który ma odpowiednie ustawienia ścieżki. Najprostszym sposobem zapewnienia tego jest użycie wiersza polecenia dla deweloperów dla programu Visual Studio.

Jednorazowa procedura instalacji przykładów programu WCF

  1. Upewnij się, że ASP.NET jest skonfigurowana. Aby uzyskać więcej informacji na temat konfigurowania ASP.NET, zobacz Internet Information Service Hosting Instructions (Instrukcje dotyczące hostingu usługi internetowego).

  2. Upewnij się, że program .NET Framework 4+ jest zainstalowany. Wyszukaj następujący katalog w wersji 4.0 (lub nowszej): \Windows\Microsoft.NET\Framework

  3. Upewnij się, że masz zainstalowany program Visual Studio 2012 lub nowszy albo system operacyjny windows Server 2008 z dodatkiem SP2 lub nowszym.

  4. Uruchom następujące polecenia. Aby uzyskać więcej informacji o tym, dlaczego te polecenia muszą być uruchamiane, zobacz Usługa hostowana usług IIS kończy się niepowodzeniem.

    Ostrzeżenie

    Jeśli usługi IIS zostaną ponownie zainstalowane, należy ponownie uruchomić następujące polecenia.

    "%WINDIR%\Microsoft.Net\Framework\v4.0.30319\aspnet_regiis" –i –enable
"%WINDIR%\Microsoft.Net\Framework\v4.0.30319\ServiceModelReg.exe" -r

    Ostrzeżenie

    Uruchomienie polecenia aspnet_regiis –i –enable spowoduje uruchomienie domyślnej puli aplikacji przy użyciu programu .NET Framework 4, co może powodować problemy z niezgodnością dla innych aplikacji na tym samym komputerze.

  5. Postępuj zgodnie z instrukcjami zapory dotyczącymi włączania portów używanych przez przykłady.

  6. Uruchom plik wsadowy Setupvroot.bat. Wykonano następujące kroki:

    • Katalog wirtualny jest tworzony w usługach IIS o nazwie ServiceModelSamples.

    • Nowe katalogi dysków są tworzone o nazwie %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples i %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples\bin.

    Jeśli wolisz ręcznie skonfigurować te katalogi, zobacz Instrukcje instalacji katalogu wirtualnego. Aby przywrócić wszystkie zmiany wprowadzone w tym kroku, uruchom cleanupvroot.bat po zakończeniu korzystania z przykładów.

    Uwaga

    Ta procedura musi być wykonywana tylko raz na komputerze, chyba że zostanie uruchomiona cleanupvroot.bat.

  7. Musisz udzielić uprawnień do modyfikowania aplikacji %SystemDrive%\inetpub\wwwroot na koncie, na którym tworzysz przykłady i użytkownika usługi sieciowej. Podczas kompilowania niektóre przykłady hostowane w sieci Web mogą próbować skopiować skompilowane pliki binarne do wcześniej wymienionej lokalizacji, a jeśli nie ustawiono odpowiednich uprawnień, kompilacja zostanie przerwana. Alternatywnie możesz pozostawić uprawnienia, ponieważ są i uruchomić wiersz polecenia zestawu SDK lub wiersz polecenia programu Visual Studio (2012) jako Administracja istrator lub skompilować przykłady w programie Visual Studio 2012, również uruchomić jako Administracja istrator.

    Uwaga

    Jeśli ten krok nie zostanie ukończony, wszystkie przykłady hostowane przez usługi IIS zakończy się niepowodzeniem podczas kompilowania. Upewnij się, że uprawnienia są ustawione poprawnie lub uruchom zarówno wiersz polecenia zestawu SDK, jak i wiersz polecenia programu Visual Studio jako Administracja istrator.

  8. Utwórz katalog C:\logs na komputerze, ponieważ niektóre przykłady mogą się spodziewać. Upewnij się, że odpowiednie konto ma dostęp do zapisu udzielony do tego folderu. W przypadku systemów Windows 7, Windows Vista i Windows Server 2008 R2 to konto jest usługą sieciową. W przypadku systemu Windows Server 2008 konto to NT Authority\Network Service. W przypadku systemów Windows XP i Windows Server 2003 konto to ASPNET.

  9. Uruchom plik Setupcerttool.bat. Ten skrypt wykonuje następujące zadania:

    • Kompiluje narzędzie FindPrivateKey.

    • Tworzy katalog o nazwie %ProgramFiles%\ServiceModelSampleTools.

    • Kopiuje nowe narzędzie FindPrivateKey do tego katalogu.

    To narzędzie jest wymagane przez przykłady korzystające z certyfikatów i są hostowane w usługach IIS.

    Uwaga

    Ze względów bezpieczeństwa pamiętaj, aby usunąć definicję katalogu wirtualnego i uprawnienia przyznane w powyższych krokach instalacji, uruchamiając plik wsadowy o nazwie cleanupvroot.bat po zakończeniu pracy z przykładami.

  10. Przykłady, które są hostowane samodzielnie (nie są hostowane w usługach IIS) wymagają uprawnień do rejestrowania adresów HTTP na komputerze na potrzeby nasłuchiwania. Uprawnienie do rezerwacji przestrzeni nazw HTTP pochodzi z konta użytkownika używanego do uruchamiania przykładu. Domyślnie konta administratorów mają uprawnienia do rejestrowania dowolnego adresu HTTP. Konta nieadministratora muszą mieć przyznane uprawnienia dla przestrzeni nazw HTTP używanych przez przykłady. Aby uzyskać więcej informacji na temat konfigurowania rezerwacji przestrzeni nazw, zobacz Konfigurowanie protokołów HTTP i HTTPS.

  11. Niektóre przykłady wymagają kolejkowania komunikatów. Aby uzyskać instrukcje instalacji, zobacz Instalowanie kolejkowania komunikatów (MSMQ).

    Uwaga

    Przed uruchomieniem wszystkich przykładów wymagających kolejkowania komunikatów upewnij się, że uruchamiasz usługę MSMQ.

  12. Niektóre przykłady wymagają certyfikatów. Zobacz Instrukcje instalacji certyfikatu serwera usług Internet Information Services (IIS).