Jednorázový postup nastavení pro ukázky Windows Communication Foundation

Většina ukázek WCF (Windows Communication Foundation) je hostovaná ve službě Internetová informační služba (IIS) a spouští se z běžného virtuálního adresáře. Tento jednorázový postup nastavení vytvoří na disku složku; Přidá také virtuální adresář do služby IIS s názvem ServiceModelSamples.

Virtuální adresář ServiceModelSamples slouží k vytváření a spouštění všech ukázek, které používají službu hostované službou IIS. Toto je jediný virtuální adresář, který je nutný ke spuštění ukázek. Sestavení ukázky nahradí všechny dříve nasazené služby v tomto virtuálním adresáři; v tomto virtuálním adresáři se nasadí a zpřístupní pouze naposledy sestavená ukázka.

Poznámka:

  • Všechny příkazy musíte spustit pod účtem místního správce. Pokud používáte Windows 7, Windows Vista nebo Windows Server 2008 R2, musíte také spustit příkazový řádek se zvýšenými oprávněními. Uděláte to tak, že kliknete pravým tlačítkem myši na ikonu příkazového řádku a potom kliknete na Spustit jako správce.
  • Všechny příkazy v tomto článku musí být spuštěny na příkazovém řádku, který má odpovídající nastavení cesty. Nejjednodušší způsob, jak to zajistit, je použití příkazového řádku pro vývojáře pro Visual Studio.

Jednorázový postup nastavení pro ukázky WCF

  1. Ujistěte se, že je nastavený ASP.NET. Další informace o nastavení ASP.NET naleznete v tématu Pokyny k hostování internetové informační služby.

  2. Ujistěte se, že je nainstalované rozhraní .NET Framework 4 nebo novější. Vyhledejte v následujícím adresáři verzi 4.0 (nebo novější): \Windows\Microsoft.NET\Framework

  3. Ujistěte se, že máte nainstalovanou sadu Visual Studio 2012 nebo novější, nebo váš operační systém je Windows Server 2008 SP2 nebo novější.

  4. Spusťte následující příkazy. Další informace o tom, proč musí být tyto příkazy spuštěny, naleznete v tématu Iis Hosted Service Selhání.

    Upozorňující

    Pokud se služba IIS přeinstaluje, bude potřeba spustit následující příkazy znovu.

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

    Upozorňující

    Spuštěním příkazu aspnet_regiis –i –enable se spustí výchozí fond aplikací pomocí rozhraní .NET Framework 4, což může způsobit problémy s nekompatibilitou pro jiné aplikace na stejném počítači.

  5. Postupujte podle pokynů brány firewall a povolte porty používané ukázkami.

  6. Spusťte dávkový soubor Setupvroot.bat. Provede se následující kroky:

    • Ve službě IIS se vytvoří virtuální adresář s názvem ServiceModelSamples.

    • Vytvoří se nové adresáře disků s názvem %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples a %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples\bin.

    Pokud chcete tyto adresáře nastavit ručně, přečtěte si pokyny k nastavení virtuálního adresáře. Pokud chcete vrátit všechny změny provedené v tomto kroku, spusťte cleanupvroot.bat po dokončení používání ukázek.

    Poznámka:

    Tento postup musí být proveden pouze jednou v počítači, pokud nespustíte cleanupvroot.bat.

  7. Musíte udělit oprávnění k úpravě pro %SystemDrive%\inetpub\wwwroot účtu, pod kterým vytváříte ukázky a uživatele síťové služby. Při sestavování se některé ukázky hostované webem můžou pokusit zkopírovat zkompilované binární soubory do dříve uvedeného umístění a pokud jste nenastavili příslušná oprávnění, sestavení se přeruší. Případně můžete oprávnění ponechat tak, jak jsou, a spustit příkazový řádek sady SDK nebo příkazový řádek sady Visual Studio (2012) jako Správa istrator nebo sestavit ukázky v sadě Visual Studio 2012, také spustit jako Správa istrator.

    Poznámka:

    Pokud tento krok není dokončený, všechny ukázky hostované službou IIS při sestavování selžou. Ujistěte se, že jste správně nastavili oprávnění, nebo spusťte příkazový řádek sady SDK i příkazový řádek sady Visual Studio jako Správa istrator.

  8. V počítači vytvořte adresář C:\logs, protože některé ukázky můžou očekávat. Ujistěte se, že má příslušný účet udělený přístup k zápisu do této složky. Pro Windows 7, Windows Vista a Windows Server 2008 R2 je tento účet síťová služba. V systému Windows Server 2008 je účet NT Authority\Network Service. V systémech Windows XP a Windows Server 2003 je účet ASPNET.

  9. Spusťte soubor Setupcerttool.bat. Tento skript provádí následující úlohy:

    • Vytvoří nástroj FindPrivateKey.

    • Vytvoří adresář s názvem %ProgramFiles%\ServiceModelSampleTools.

    • Zkopíruje nový nástroj FindPrivateKey do tohoto adresáře.

    Tento nástroj vyžaduje ukázky, které používají certifikáty a jsou hostované ve službě IIS.

    Poznámka:

    Pro účely zabezpečení nezapomeňte odebrat definici virtuálního adresáře a oprávnění udělená v krocích instalace výše spuštěním dávkového souboru s názvem cleanupvroot.bat po dokončení s ukázkami.

  10. Ukázky, které jsou v místním prostředí (nejsou hostované ve službě IIS), vyžadují oprávnění k registraci adres HTTP v počítači pro naslouchání. Oprávnění k rezervaci oboru názvů HTTP pochází z uživatelského účtu použitého ke spuštění ukázky. Ve výchozím nastavení mají účty správců oprávnění k registraci jakékoli adresy HTTP. Účty bez oprávnění správce musí mít udělená oprávnění pro obory názvů HTTP používané ukázkami. Další informace o konfiguraci rezervací oboru názvů najdete v tématu Konfigurace HTTP a HTTPS.

  11. Některé ukázky vyžadují službu Řízení front zpráv. Pokyny k instalaci najdete v tématu Instalace služby Řízení front zpráv (MSMQ ).

    Poznámka:

    Před spuštěním jakýchkoli ukázek, které vyžadují službu Řízení front zpráv, nezapomeňte spustit službu MSMQ.

  12. Některé ukázky vyžadují certifikáty. Viz pokyny k instalaci certifikátu serveru Internetová informační služba (IIS).