Einmaliges Setupverfahren für Windows Communication Foundation-Beispiele

Die meisten Windows Communication Foundation-WCF-Beispiele werden in Internet Information Services (IIS) gehostet und aus einem gemeinsamen virtuellen Verzeichnis ausgeführt. Diese einmalige Einrichtungsprozedur erstellt einen Ordner auf dem Datenträger. es fügt außerdem ein virtuelles Verzeichnis zu IIS namens ServiceModelSamples hinzu.

Das virtuelle Verzeichnis ServiceModelSamples wird zum Erstellen und Ausführen aller Beispiele verwendet, die einen von IIS gehosteten Dienst verwenden. Dies ist das einzige virtuelle Verzeichnis, das zum Ausführen der Beispiele erforderlich ist. Durch das Erstellen eines Beispiels werden alle zuvor bereitgestellten Dienste in diesem virtuellen Verzeichnis ersetzt. Nur das zuletzt erstellte Beispiel wird bereitgestellt und in diesem virtuellen Verzeichnis verfügbar.

Einmaliges Setupverfahren für WCF-Beispiele

1. Stellen Sie sicher, dass ASP.NET eingerichtet ist. Weitere Informationen zum Einrichten von ASP.NET finden Sie in den Hostinganweisungen des Internetinformationsdiensts.

2. Stellen Sie sicher, dass .NET Framework 4+ installiert ist. Durchsuchen Sie das folgende Verzeichnis nach v4.0 (oder höher): \Windows\Microsoft.NET\Framework

3. Stellen Sie sicher, dass Visual Studio 2012 oder höher installiert ist oder Ihr Betriebssystem Windows Server 2008 SP2 oder höher ist.

4. Führen Sie die folgenden Befehle aus. Weitere Informationen dazu, warum diese Befehle ausgeführt werden müssen, finden Sie unter IIS Hosted Service Fails.

   Warnung

   Wenn IIS erneut installiert wird, müssen die folgenden Befehle erneut ausgeführt werden.

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

   Warnung

   Wenn Sie den Befehl aspnet_regiis -i -enable ausführen, wird der Standard-App-Pool mit .NET Framework 4 ausgeführt, was zu Inkompatibilitätsproblemen für andere Anwendungen auf demselben Computer führen kann.

5. Befolgen Sie die Firewallanweisungen , um die von den Beispielen verwendeten Ports zu aktivieren.

6. Führen Sie die Setupvroot.bat Batchdatei aus. Die folgenden Schritte werden ausgeführt:

   • Ein virtuelles Verzeichnis wird in IIS mit dem Namen ServiceModelSamples erstellt.

   • Es werden die neuen Datenträgerverzeichnisse %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples und %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples\bin erstellt.

   Wenn Sie diese Verzeichnisse lieber manuell einrichten möchten, lesen Sie die Anweisungen zum Einrichten des virtuellen Verzeichnisses. Wenn Sie alle in diesem Schritt vorgenommenen Änderungen wiederherstellen möchten, führen Sie cleanupvroot.bat aus, nachdem Sie die Verwendung der Beispiele abgeschlossen haben.

   Hinweis

   Dieses Verfahren muss nur einmal auf einem Computer ausgeführt werden, es sei denn, Sie führen cleanupvroot.bataus.

7. Sie müssen die Berechtigung zum Ändern für %SystemDrive%\inetpub\wwwroot für das Konto erteilen, unter dem Sie die Beispiele und den Netzwerkdienstbenutzer erstellen. Während der Erstellung versuchen einige webgehostete Beispiele möglicherweise, die kompilierten Binärdateien an den zuvor erwähnten Speicherort zu kopieren, und wenn Sie die entsprechenden Berechtigungen nicht festgelegt haben, wird der Build abgebrochen. Alternativ können Sie die Berechtigungen unverändert lassen und die SDK-Eingabeaufforderung oder die Visual Studio-Eingabeaufforderung (2012) als Administrator ausführen oder die Beispiele in Visual Studio 2012 auch als Administrator ausführen.

   Hinweis

   Wenn dieser Schritt nicht abgeschlossen ist, treten beim Erstellen alle von IIS gehosteten Beispiele fehl. Stellen Sie sicher, dass Sie die Berechtigungen richtig festlegen oder sowohl die SDK-Eingabeaufforderung als auch die Visual Studio-Eingabeaufforderung als Administrator ausführen.

8. Erstellen Sie ein Verzeichnis "C:\logs" auf dem Computer, da einige Beispiele möglicherweise darauf angewiesen sind. Stellen Sie sicher, dass dem entsprechenden Konto Schreibzugriff auf diesen Ordner gewährt wurde. Für Windows 7, Windows Vista und Windows Server 2008 R2 ist dieses Konto der Netzwerkdienst. Für Windows Server 2008 ist das Konto NT Authority\Network Service. Für Windows XP und Windows Server 2003 ist das Konto ASPNET.

9. Führen Sie die Setupcerttool.bat Datei aus. Dieses Skript führt die folgenden Aufgaben aus:

   • Erstellt das FindPrivateKey-Tool.

   • Erstellt ein Verzeichnis namens %ProgramFiles%\ServiceModelSampleTools.

   • Kopiert das neue FindPrivateKey-Tool in dieses Verzeichnis.

   Dieses Tool wird von Beispielen benötigt, die Zertifikate verwenden und in IIS gehostet werden.

   Hinweis

   Denken Sie für Sicherheitszwecke daran, die in den oben aufgeführten Setupschritten erteilten virtuellen Verzeichnisdefinition und Berechtigungen zu entfernen, indem Sie die Batchdatei mit dem Namen cleanupvroot.bat ausführen, nachdem Sie die Beispiele abgeschlossen haben.

10. Für selbst gehostete Beispiele (nicht in IIS gehostet) ist auf dem Computer die Berechtigung zum Registrieren von HTTP-Adressen für die Überwachung erforderlich. Die Berechtigung für eine HTTP-Namespacereservierung stammt aus dem Benutzerkonto, das zum Ausführen des Beispiels verwendet wird. Standardmäßig verfügen Administratorkonten über die Berechtigung zum Registrieren einer BELIEBIGEN HTTP-Adresse. Nicht-Administratorkonten müssen die Berechtigung für die HTTP-Namespaces erhalten, die von den Beispielen verwendet werden. Weitere Informationen zum Konfigurieren von Namespacereservierungen finden Sie unter Konfigurieren von HTTP und HTTPS.

11. Für einige Beispiele ist Message Queuing erforderlich. Installationsanweisungen finden Sie unter Installieren von Message Queuing (MSMQ ).

    Hinweis

    Stellen Sie sicher, dass Sie den MSMQ-Dienst starten, bevor Sie Beispiele ausführen, die Message Queuing erfordern.

12. Einige Beispiele erfordern Zertifikate. Siehe Installationsanweisungen für Internetinformationsdienste (IIS)-Serverzertifikate.