Einmaliges Setupverfahren für Windows Communication Foundation-BeispieleOne-Time Setup Procedure for the Windows Communication Foundation Samples

Die meisten der Windows Communication Foundation (WCF)-Beispiele sind in Internet Information Services (IIS) gehostet, und führen Sie von einem gemeinsamen virtuellen Verzeichnisses.Most of the Windows Communication Foundation (WCF) samples are hosted in Internet Information Services (IIS) and run from a common virtual directory. Diesem einmaligen Setupverfahren wird ein Ordner erstellt, auf dem Datenträger; Es fügt auch ein virtuelles Verzeichnis in IIS ServiceModelSamples.This one-time setup procedure creates a folder on the disk; it also adds a virtual directory to IIS named ServiceModelSamples.

Die ServiceModelSamples virtuelles Verzeichnis wird zum Erstellen und Ausführen aller Beispiele verwendet, die einen IIS-gehosteten Dienst zu verwenden.The ServiceModelSamples virtual directory is used for building and running all samples that use an IIS-hosted service. Dies ist das einzige virtuelle Verzeichnis, das zum Ausführen der Beispiele erforderlich ist.This is the only virtual directory that is required to run the samples. Durch die Erstellung eines Beispiels werden alle zuvor bereitgestellten Dienste in diesem virtuellen Verzeichnis ersetzt. Nur das zuletzt erstellte Beispiel wird bereitgestellt und ist dann in diesem virtuellen Verzeichnis verfügbar.Building a sample will replace any previously deployed service at this virtual directory; only the most recently built sample will be deployed and available in this virtual directory.

Hinweis

Sie müssen alle Befehle unter einem lokalen Administratorkonto ausführen.You must run all commands under a local administrator account. Wenn Sie mit Windows 7, Windows VistaWindows Vista oder Windows Server 2008 R2 arbeiten, müssen Sie außerdem die Eingabeaufforderung mit erweiterten Berechtigungen ausführen.If you are using Windows 7, Windows VistaWindows Vista, or Windows Server 2008 R2, you must also run the command prompt with elevated privileges. Zu diesem Zweck mit der rechten Maustaste des Symbol "Eingabeaufforderung", und klicken Sie dann auf als Administrator ausführen.To do so, right-click the command prompt icon, and then click Run as administrator. Alle Befehle in diesem Thema müssen an einer Eingabeaufforderung ausgeführt werden, die über die richtigen Pfadeinstellungen verfügt.All commands in this topic must be run in a command prompt that has the appropriate path settings. Dies kann am einfachsten sichergestellt werden, wenn Sie die Visual Studio-Eingabeaufforderung verwenden.The easiest way to ensure this is by using the Visual Studio Command Prompt. Um diese Aufforderung zu öffnen, klicken Sie auf startenOption Programme, führen Sie einen Bildlauf nach unten bis zum Visual Studio 2010Option Visual Studio-Tools, mit der rechten Maustaste Visual Studio-Eingabeaufforderung (2010), und klicken Sie dann auf als Administrator ausführen.To open this prompt, click Start, select All Programs, scroll down to Visual Studio 2010, select Visual Studio Tools, right-click Visual Studio Command Prompt (2010), and then click Run as administrator. Wenn Sie eine Visual Studio Express Edition installiert haben, ist diese Eingabeaufforderung nicht verfügbar. In diesem Fall müssen Sie dem Systempfad "C:\Windows\Microsoft.Net\Framework\v4.0" hinzufügen.If you have one of the Visual Studio Express editions installed, this command prompt is not available, and you will have to add "C:\Windows\Microsoft.Net\Framework\v4.0" to the system path.

Einmaliges Setupverfahren für WCF-BeispieleOne-time setup procedure for WCF samples

  1. Stellen Sie sicher, dass ASP.NETASP.NET eingerichtet ist.Ensure that ASP.NETASP.NET is set up. Weitere Informationen über das Einrichten von ASP.NETASP.NET, finden Sie unter Internet-Internetinformationsdiensts.For more information about how to set up ASP.NETASP.NET, see Internet Information Service Hosting Instructions.

  2. Stellen Sie sicher, dass .NET Framework Version 4.NET Framework version 4 installiert ist.Ensure that .NET Framework Version 4.NET Framework version 4 is installed. Durchsuchen Sie das folgende Verzeichnis nach v4. 0 (oder höher): \Windows\Microsoft.NET\FrameworkSearch the following directory for v4.0 (or later): \Windows\Microsoft.NET\Framework

  3. Wenn Visual Studio 2012Visual Studio 2012 nicht installiert ist, und das Betriebssystem ist nicht Windows Server 2008 SP2 oder höher installieren Hotfix 251798.If Visual Studio 2012Visual Studio 2012 is not installed, and your operating system is not Windows Server 2008 SP2 or later, install Hotfix 251798.

  4. Führen Sie die folgenden Befehle durch.Run the following commands. Weitere Informationen dazu, warum diese Befehle ausgeführt werden müssen, finden Sie unter IIS-Hostdienst.For more information about why these commands must be run, see IIS Hosted Service Fails.

    Warnung

    Wenn IIS neu installiert wird, müssen die folgenden Befehle noch einmal ausgeführt werden.If IIS is reinstalled, the following commands will need to be run again.

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

    Warnung

    Ausführen des Befehls aspnet_regiis –i –enable führt dazu, dass der Standardanwendungspool ausführen mit .NET Framework 4.NET Framework 4, dadurch kann es zu Inkompatibilitätsproblemen bei anderen Anwendungen auf demselben Computer.Running the command aspnet_regiis –i –enable will make the Default App Pool run using .NET Framework 4.NET Framework 4, which may produce incompatibility issues for other applications on the same computer.

  5. Führen Sie die Firewall-Anweisungen zum Aktivieren von den Beispielen verwendeten Ports.Follow the Firewall Instructions for enabling the ports used by the samples.

  6. Überprüfen Sie die folgenden Standardverzeichnis: <Installationslaufwerk >:\WF_WCF_Samples.Check for the following default directory: <InstallDrive>:\WF_WCF_Samples. Wenn die Beispiele bereits installiert wurden, ist dies das Standardverzeichnis.If the samples were previously installed, this is the default directory.

  7. Wenn die Beispiele sind nicht installiert sind, installieren Sie sie von den Downloadpfad Beispiele für Visual C#- oder Visual Basic.If the samples are not installed, install them from the samples download location for Visual C# or Visual Basic.

  8. Nach dem Installieren der Beispiele, wechseln Sie zu: <Installationslaufwerk >:\WF_WCF_Samples\WCF\Setup\After installing the samples, go to : <InstallDrive>:\WF_WCF_Samples\WCF\Setup\

  9. Führen Sie die Setupvroot.bat Batchdatei.Run the Setupvroot.bat batch file. Die folgenden Schritte werden ausgeführt:The following steps are performed:

    • In IIS wird ein virtuelles Verzeichnis mit dem Namen ServiceModelSamples erstellt.A virtual directory is created in IIS named ServiceModelSamples.

    • Es werden die neuen Datenträgerverzeichnisse %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples und %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples\bin erstellt.New disk directories are created named %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples and %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples\bin.

    Wenn Sie diese Verzeichnisse manuell einrichten möchten, finden Sie unter der virtuellen Verzeichnis Setupanweisungen.If you prefer to set up these directories manually, see the Virtual Directory Setup Instructions. Um alle in diesem Schritt vorgenommenen Änderungen rückgängig zu machen, führen Sie cleanupvroot.bat aus, sobald die Beispiele nicht mehr benötigt werden.To revert all changes done in this step, run cleanupvroot.bat after you finish using the samples.

    Hinweis

    Diese Prozedur muss nur einmal auf einem Computer ausgeführt werden, es sei denn, cleanupvroot.bat wird ausgeführt.This procedure must be performed only once on a computer, unless cleanupvroot.bat is run.

  10. Sie müssen dem Konto, unter dem Sie die Beispiele erstellen, und dem Netzwerkdienstbenutzer die Berechtigung zum Ändern von %SystemDrive%\inetpub\wwwroot zuweisen.You must grant permission to modify for %SystemDrive%\inetpub\wwwroot to the account under which you are building the samples and the Network Service user. Beim Erstellen wird bei einigen im Internet gehosteten Beispielen möglicherweise 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.While building, some Web-hosted samples might attempt to copy the compiled binaries to the previously mentioned location, and if you have not set the appropriate permissions, the build will break. Sie können die Berechtigungen aber auch unverändert lassen und die SDK-Eingabeaufforderung oder die Visual Studio-Eingabeaufforderung (2012) als Administrator ausführen, oder Sie können die Beispiele als Administrator in Visual Studio 2012Visual Studio 2012 erstellen.Alternatively, you can leave the permissions as they are and run the SDK command prompt or Visual Studio Command Prompt (2012) as Administrator, or build the samples in Visual Studio 2012Visual Studio 2012, also run as Administrator.

    Hinweis

    Wenn dieser Schritt nicht ausgeführt wird, lässt sich keines der von IIS gehosteten Beispiele erstellen.If this step is not completed, all IIS-hosted samples will fail while building. Legen Sie die Berechtigungen unbedingt richtig fest, oder führen Sie die SDK-Eingabeaufforderung und Visual Studio-Eingabeaufforderung (2012) als Administrator aus.Ensure that you set the permissions correctly, or run both the SDK command prompt and Visual Studio Command Prompt (2012) as Administrator.

  11. Erstellen Sie das Verzeichnis C:\logs auf dem Computer. Möglicherweise wird es bei einigen Beispielen vorausgesetzt.Create a C:\logs directory on the computer; some samples might be expecting it. Stellen Sie sicher, dass das entsprechende Konto Schreibzugriff auf diesen Ordner hat.Make sure that the appropriate account has write access granted to this folder. Für Windows 7 Windows VistaWindows Vista, und Windows Server 2008 R2, dieses Konto ist Netzwerkdienst.For Windows 7, Windows VistaWindows Vista, and Windows Server 2008 R2, this account is Network Service. Unter Windows Server 2008Windows Server 2008 ist es das Konto NT-Autorität\Netzwerkdienst.For Windows Server 2008Windows Server 2008, the account is NT Authority\Network Service. Unter Windows XPWindows XP und Windows Server 2003Windows Server 2003 lautet das Konto ASPNET.For Windows XPWindows XP and Windows Server 2003Windows Server 2003, the account is ASPNET.

  12. Führen Sie die Datei "Setupcerttool.bat" aus.Run the Setupcerttool.bat file. Diese Datei befindet sich der <Datei "Setup.xml" > \WF_WCF_Samples\WCF\Setup-Ordner.This file is located in the <InstallPath>\WF_WCF_Samples\WCF\Setup\ folder. Mit diesem Skript werden folgende Aufgaben ausgeführt:This script will perform the following tasks:

    • Erstellen des Tools FindPrivateKeyBuild the FindPrivateKey tool.

    • Erstellen eines Verzeichnisses mit dem Namen %ProgramFiles%\ServiceModelSampleToolsCreate a directory called %ProgramFiles%\ServiceModelSampleTools.

    • Kopieren Sie das neue Tool FindPrivateKey in dieses Verzeichnis.Copy the new FindPrivateKey tool to this directory.

    Dieses Tool ist für Beispiele erforderlich, die Zertifikate verwenden und in IIS gehostet werden.This tool is required by samples that use certificates and are hosted in IIS.

    Hinweis

    Entfernen Sie aus Sicherheitsgründen die Definition des virtuellen Verzeichnisses und die in den vorhergehenden Setupschritten gewährten Berechtigungen, indem Sie die Batchdatei Cleanupvroot.bat nach Abschluss der Beispiele ausführen.For security purposes, remember to remove the virtual directory definition and permissions granted in the setup steps above by running the batch file named Cleanupvroot.bat after you are finished with the samples.

  13. 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.Samples that are self-hosted (not hosted in IIS) require permission to register HTTP addresses on the computer for listening. Die Berechtigung für eine HTTP-Namespacereservierung wird von dem Benutzerkonto übernommen, das zum Ausführen des Beispiels verwendet wird.The permission for an HTTP namespace reservation comes from the user account used to run the sample. Standardmäßig verfügen Administratorkonten über die Berechtigung zum Registrieren von HTTP-Adressen.By default, administrator accounts have the permission to register any HTTP address. Nicht-Administratorkonten muss die Berechtigung für die von den Beispielen verwendeten HTTP-Namespaces gewährt werden.Non-administrator accounts must be granted permission for the HTTP namespaces used by the samples. Weitere Informationen zum Konfigurieren von Namespacereservierungen finden Sie unter Configuring HTTP and HTTPS.For more information about how to configure namespace reservations, see Configuring HTTP and HTTPS.

  14. Für einige Beispiele ist Message Queuing erforderlich.Some samples require Message Queuing. Finden Sie unter Installieren von Message Queuing (MSMQ) installationsanweisungen.See Installing Message Queuing (MSMQ) for installation instructions.

    Hinweis

    Stellen Sie sicher, dass der MSMQ-Dienst gestartet wurde, bevor Sie Beispiele ausführen, für die Message Queuing erforderlich ist.Ensure that you start the MSMQ service before you run any samples that require Message Queuing.

  15. Einige Beispiele erfordern Zertifikate.Some samples require certificates. Finden Sie unter Internetinformation Services (IIS)-Server-Zertifikat-Installationsanweisungen.See Internet Information Services (IIS) Server Certificate Installation Instructions.

Siehe auchSee Also