Beispiele zum einmaligen Setupverfahren für Windows Communication Foundation

  • Artikel

Die meisten Windows Communication Foundation (WCF)-Beispiele werden in Internetinformationsdienste (IIS) gehostet und von einem gemeinsamen virtuellen Verzeichnis ausgeführt. In diesem einmaligen Setupverfahren werden ein Ordner auf dem Datenträger und das virtuelle Verzeichnis "servicemodelsamples" erstellt.

Das virtuelle Verzeichnis servicemodelsamples wird zum Erstellen und Ausführen aller Beispiele verwendet, in denen ein von IIS gehosteter Dienst verwendet wird. Dies ist das einzige virtuelle Verzeichnis, das zum Ausführen der Beispiele erforderlich ist. Das zuletzt erstellte Beispiel wird in diesem virtuellen Verzeichnis bereitgestellt und ist dort verfügbar. Durch das Erstellen eines anderen Beispiels wird der zuvor in diesem virtuellen Verzeichnis bereitgestellte Dienst ersetzt.

Tipp

In der folgenden Prozedur müssen Sie alle Befehle unter einem lokalen Administratorkonto ausführen. Wenn Sie mit Windows Vista oder Windows Server 2008 arbeiten, müssen Sie auch die Eingabeaufforderung mit erhöhten Rechten ausführen. Klicken Sie hierzu mit der rechten Maustaste auf das Symbol für die Eingabeaufforderung, und klicken Sie dann auf Als Administrator ausführen.

Beispiele zum einmaligen Setupverfahren für WCF

  1. Stellen Sie sicher, dass .NET Framework 3.0 installiert ist. Einige Beispiele erfordern .NET Framework, Version 3.5. Wenn Sie diese Beispiele ausführen möchten, müssen Sie daher sicherstellen, dass .NET Framework 3.5 installiert ist.

  2. Stellen Sie sicher, dass ASP.NET eingerichtet ist. Weitere Informationen zum Einrichten von ASP.NET finden Sie unter Hostinganweisungen des Internetinformationsdiensts.

  3. Wenn Sie IIS nach der Installation von WCF installiert haben, müssen Sie die entsprechenden Scriptzuordnungen in IIS registrieren: Wenn Sie mit Windows Vista oder Windows Server 2008 arbeiten, müssen Sie in Schritt 2 die HTTP-Aktivierung durchgeführt haben. Wenn Sie Windows XP SP2 oder Windows Server 2003 verwenden, führen Sie folgenden Befehl aus.

    Tipp

    Führen Sie diesen Befehl nicht aus, wenn Sie Windows Vista oder Windows Server 2008 verwenden.

    "%WINDIR%\Microsoft.Net\Framework\v3.0\Windows Communication Foundation\ServiceModelReg.exe" -r

  4. Wenn Sie .NET Framework 3.5 installiert haben, führen Sie den folgenden Befehl aus.

    "%WINDIR%\Microsoft.Net\Framework\v3.5\WFServicesReg.exe" /c

  5. Folgen Sie den Firewall-Anweisungen zum Aktivieren der im Beispiel verwendeten Anschlüsse.

  6. Laden Sie die Setupdateien von dieser Seite herunter.

  7. Führen Sie die Batchdatei Setupvroot.bat aus.

    • Es wird ein virtuelles Verzeichnis mit dem Namen servicemodelsamples erstellt.
    • Es werden die Datenträgerverzeichnisse %SystemDrive%\Inetpub\wwwroot\servicemodelsamples und %SystemDrive%\Inetpub\wwwroot\servicemodelsamples\bin erstellt.
    • Wenn Sie Verzeichnisse manuell einrichten möchten, finden Sie Informationen unter Anleitung zum Einrichten eines virtuellen Verzeichnisses.

    Tipp

    Diese Prozedur muss nur einmal auf einem Computer ausgeführt werden.

  8. Sie müssen dem Konto, unter dem Sie die Beispiele erstellen, die Berechtigung zum Ändern von %SystemDrive%\inetpub\wwwroot zuweisen. Beim Erstellen wird bei einigen im Web gehosteten Beispielen versucht, die kompilierten Binärdateien an den oben genannten Speicherort zu kopieren. Wenn Sie nicht die entsprechenden Berechtigungen festgelegt haben, können die Beispiele nicht erstellt werden. Sie können die Berechtigungen aber auch unverändert lassen und die SDK-Eingabeaufforderung oder Visual Studio als Administrator ausführen.

    Tipp

    Wenn dieser Schritt nicht ausgeführt wird, lässt sich keines der von IIS gehosteten Beispiele erstellen. Legen Sie die Berechtigungen unbedingt richtig fest, oder führen Sie die SDK-Eingabeaufforderung und Visual Studio als Administrator aus.

  9. Erstellen Sie auf dem Computer das Verzeichnis "c:\logs". Dies wird bei einigen Beispielen erwartet (wie vom Beispiel Erweitern der Kontrolle über Fehlerbehandlung und -meldung). Weisen Sie dem entsprechenden Konto Schreibberechtigungen für den Ordner zu. Für Windows Vista und Windows Server 2008 lautet das Konto NT Authority\Network Service, für Windows XP und Windows Server 2003 lautet das Konto ASPNET.

  10. Führen Sie die Datei "Setupcerttool.bat" aus. Diese Datei befindet sich im Ordner "\TechnologySamples\Setup\CS" (oder "\TechnologySamples\Setup\VB") unter dem Installationsordner für WCF-Beispiele:

    • Das Tool FindPrivateKey wird erstellt.
    • Unter %ProgramFiles%\ServiceModelSampleTools wird ein Verzeichnis erstellt.
    • FindPrivateKey wird in dieses Verzeichnis kopiert.

    Dieses Tool ist für Beispiele erforderlich, die Zertifikate verwenden und in IIS gehostet werden.

  11. Für selbst gehostete Beispiele (nicht in IIS gehostet) ist die Berechtigung zum Registrieren von HTTP-Adressen auf dem Computer für die Überwachung erforderlich. Die Berechtigung für eine HTTP-Namespacereservierung wird für das Benutzerkonto festgelegt, das zum Ausführen des Beispiels verwendet wird. Standardmäßig verfügen Administratorkonten über die Berechtigung zum Registrieren von HTTP-Adressen. Nicht-Administratorkonten muss die Berechtigung für von den Beispielen verwendete HTTP-Namespaces gewährt werden. Weitere Informationen dazu, wie Namespacereservierungen konfiguriert werden, finden Sie unter Configuring HTTP and HTTPS.

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

Hinweis   Entfernen Sie aus Sicherheitsgründen die Definition des virtuellen Verzeichnisses und die in den Setupschritten gewährten Berechtigungen, wenn Sie die Beispiele abgeschlossen haben, indem Sie die Batchdatei "Cleanupvroot.bat" ausführen.

Send comments about this topic to Microsoft.
© 2007 Microsoft Corporation. All rights reserved.