Aracılığıyla paylaş

Windows Communication Foundation örnekleri için One-Time Kurulum Prosedürü

Windows Communication Foundation (WCF) örneklerinin çoğu Internet Information Services'te (IIS) barındırılır ve ortak bir sanal dizinden çalıştırılır. Bu tek seferlik kurulum yordamı diskte bir klasör oluşturur; Ayrıca IIS'ye ServiceModelSamples adlı bir sanal dizin ekler.

ServiceModelSamples sanal dizini, IIS tarafından barındırılan bir hizmet kullanan tüm örnekleri oluşturmak ve çalıştırmak için kullanılır. Bu, örnekleri çalıştırmak için gereken tek sanal dizindir. Örnek oluşturmak, bu sanal dizinde daha önce dağıtılan herhangi bir hizmetin yerini alır; yalnızca en son oluşturulan örnek bu sanal dizinde dağıtılır ve kullanılabilir.

Uyarı

  • Tüm komutları yerel yönetici hesabı altında çalıştırmanız gerekir. Windows 7, Windows Vista veya Windows Server 2008 R2 kullanıyorsanız, komut istemini yükseltilmiş ayrıcalıklarla da çalıştırmanız gerekir. Bunu yapmak için komut istemi simgesine sağ tıklayın ve ardından Yönetici olarak çalıştır'a tıklayın.
  • Bu makaledeki tüm komutlar, uygun yol ayarlarına sahip bir komut isteminde çalıştırılmalıdır. Bunu sağlamanın en kolay yolu , Visual Studio için Geliştirici Komut İstemi'ni kullanmaktır.

WCF örnekleri için tek seferlik kurulum yordamı

  1. ASP.NET ayarlandığından emin olun. ASP.NET ayarlama hakkında daha fazla bilgi için bkz. Internet Information Service Barındırma Yönergeleri.

  2. .NET Framework 4+ uygulamasının yüklü olduğundan emin olun. Aşağıdaki dizinde v4.0 (veya üzeri) arayın: \Windows\Microsoft.NET\Framework

  3. Visual Studio 2012 veya sonraki bir sürümün yüklü olduğundan veya işletim sisteminizin Windows Server 2008 SP2 veya üzeri olduğundan emin olun.

  4. Aşağıdaki komutları çalıştırın. Bu komutların neden çalıştırılması gerektiği hakkında daha fazla bilgi için bkz. IIS Barındırılan Hizmet Başarısız Oluyor.

    Uyarı

    IIS yeniden yüklenirse, aşağıdaki komutların yeniden çalıştırılması gerekir.

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

    Uyarı

    komutu aspnet_regiis –i –enable çalıştırıldığında, .NET Framework 4 kullanılarak Varsayılan Uygulama Havuzu çalıştırılır ve bu da aynı bilgisayardaki diğer uygulamalar için uyumsuzluk sorunlarına neden olabilir.

  5. Örnekler tarafından kullanılan bağlantı noktalarını etkinleştirmek için Güvenlik Duvarı Yönergeleri'ni izleyin.

  6. Setupvroot.bat toplu iş dosyasını çalıştırın. Aşağıdaki adımlar gerçekleştirilir:

    • IIS'de ServiceModelSamples adlı bir sanal dizin oluşturulur.

    • \Inetpub\wwwroot\ServiceModelSamples %SystemDrive%adlı yeni disk dizinleri oluşturulur ve \Inetpub\wwwroot\ServiceModelSamples\bin %SystemDrive%.

    Bu dizinleri el ile ayarlamayı tercih ediyorsanız Bkz. Sanal Dizin Kurulum Yönergeleri. Bu adımda yapılan tüm değişiklikleri geri almak için, örnekleri kullanmayı bitirdikten sonra cleanupvroot.bat çalıştırın.

    Uyarı

    cleanupvroot.batçalıştırmadığınız sürece, bu yordam bilgisayarda yalnızca bir kez gerçekleştirilmelidir.

  7. Örnekleri oluşturduğunuz hesap ve Ağ Hizmeti kullanıcısına \inetpub\wwwroot %SystemDrive%üzerinde değişiklik yapma izni vermelisiniz. Derleme sırasında, bazı Web'de barındırılan örnekler derlenmiş ikili dosyaları daha önce bahsedilen konuma kopyalamaya çalışabilir ve uygun izinleri ayarlamadıysanız derleme bozulacaktır. Alternatif olarak, izinleri olduğu gibi bırakabilir ve SDK komut istemini veya Visual Studio Komut İstemi'ni (2012) Yönetici olarak çalıştırabilir veya örnekleri Visual Studio 2012'de derleyebilir ve Yönetici olarak da çalıştırabilirsiniz.

    Uyarı

    Bu adım tamamlanmazsa, iis tarafından barındırılan tüm örnekler oluşturulurken başarısız olur. İzinleri doğru ayarladığınızdan emin olun veya hem SDK komut istemini hem de Visual Studio Komut İstemini Yönetici olarak çalıştırın.

  8. Bilgisayarda, bazı örneklerin bunu bekleyebileceği ihtimaline karşı bir C:\logs dizini oluşturun. Uygun hesabın bu klasöre yazma erişimi verildiğinden emin olun. Windows 7, Windows Vista ve Windows Server 2008 R2 için bu hesap Ağ Hizmeti'dir. Windows Server 2008 için hesap NT Authority\Network Service şeklindedir. Windows XP ve Windows Server 2003 için hesap ASPNET'tir.

  9. Setupcerttool.bat dosyasını çalıştırın. Bu betik aşağıdaki görevleri gerçekleştirir:

    • FindPrivateKey aracını oluşturur.

    • \ServiceModelSampleTools %ProgramFiles%adlı bir dizin oluşturur.

    • Yeni FindPrivateKey aracını bu dizine kopyalar.

    Bu araç, sertifika kullanan ve IIS'de barındırılan örnekler için gereklidir.

    Uyarı

    Güvenlik amacıyla, örnekleri tamamladıktan sonra cleanupvroot.bat adlı toplu iş dosyasını çalıştırarak yukarıdaki kurulum adımlarında verilen sanal dizin tanımını ve izinleri kaldırmayı unutmayın.

  10. Kendi kendine barındırılan (IIS'de barındırılmayan) örnekler, dinleme amaçlı bilgisayarda HTTP adreslerini kaydetmek için izin gerektirir. HTTP ad alanı ayırma izni, örneği çalıştırmak için kullanılan kullanıcı hesabından gelir. Varsayılan olarak, yönetici hesapları herhangi bir HTTP adresini kaydetme iznine sahiptir. Yönetici olmayan hesaplara örnekler tarafından kullanılan HTTP ad alanları için izin verilmelidir. Ad alanı rezervasyonlarını yapılandırma hakkında daha fazla bilgi için bkz. HTTP ve HTTPS'yi yapılandırma.

  11. Bazı örnekler Mesaj Kuyruklama gerektirir. Bkz Message Queuing'i (MSMQ) Yükleme yükleme yönergeleri için.

    Uyarı

    Message Queuing gerektiren örnekleri çalıştırmadan önce MSMQ hizmetini başlattığınızdan emin olun.

  12. Bazı örnekler sertifika gerektirir. Bkz. Internet Information Services (IIS) Sunucusu Sertifikası Yükleme Yönergeleri.