Udostępnij za pośrednictwem

procedura instalacji One-Time dla przykładów programu Windows Communication Foundation

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 / Notatka

  • 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ług informacyjnych w Internecie).

  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ć wykonywane, zobacz Niepowodzenie usługi hostowanej w IIS.

    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 otwierania portów używanych przez próbki.

  6. Uruchom plik wsadowySetupvroot.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 / Notatka

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

  7. Musisz udzielić uprawnień do modyfikowania dla %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 tak jak są i uruchomić wiersz polecenia zestawu SDK lub wiersz polecenia programu Visual Studio (2012) jako administrator, albo skompilować przykłady w programie Visual Studio 2012, również uruchomione jako administrator.

    Uwaga / Notatka

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

  8. Utwórz katalog C:\logs na komputerze, ponieważ niektóre przykłady mogą się spodziewać. Upewnij się, że odpowiednie konto ma przyznany dostęp do zapisu w tym folderze. 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 plikSetupcerttool.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 hostowane w IIS.

    Uwaga / Notatka

    Ze względów bezpieczeństwa pamiętaj, aby usunąć definicję katalogu wirtualnego i uprawnienia przyznane w powyższych krokach konfiguracji, 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 nieadministracyjne muszą mieć przyznane uprawnienia do 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 / Notatka

    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).