Uzak IIS Bilgisayarında Uzaktan Hata Ayıklama ASP.NET
IIS'ye dağıtılan bir ASP.NET uygulamasında hata ayıklamak için, uygulamanızı dağıttığınız bilgisayara uzak araçları yükleyip çalıştırın ve ardından Visual Studio'dan çalışan uygulamanıza ekleyin.
Bu kılavuzda bir Visual Studio ASP.NET MVC 4.8 uygulamasını ayarlama ve yapılandırma, IIS'ye dağıtma ve Visual Studio'dan uzaktan hata ayıklayıcı ekleme açıklanmaktadır.
Not
Bunun yerine ASP.NET Core'da uzaktan hata ayıklamak için bkz . IIS Bilgisayarında Uzaktan Hata Ayıklama ASP.NET Çekirdek. Azure Uygulaması Hizmeti için bkz. Azure'da Core ASP.NET uzaktan hata ayıklama veya Visual Studio Enterprise için Snapshot Debugger'ı kullanma (.NET 4.6.1 gereklidir).
Önkoşullar
Bu makalede gösterilen adımları izlemek için Visual Studio 2019 veya sonraki bir sürüm gereklidir.
Bu yordamlar şu sunucu yapılandırmalarında test edilmiştir:
- Windows Server 2022 ve IIS 10
- Windows Server 2012 R2 ve IIS 8 (Windows Server 2008 R2 için sunucu adımları farklıdır)
Ağ gereksinimleri
Uzaktan hata ayıklayıcı, Windows Server 2008 Service Pack 2'den başlayarak Windows Server'da desteklenir. Gereksinimlerin tam listesi için bkz . Gereksinimler.
Not
Ara sunucu aracılığıyla bağlanan iki bilgisayar arasında hata ayıklama desteklenmez. Arama İnterneti gibi yüksek gecikme süresi veya düşük bant genişliğine sahip bir bağlantı üzerinden veya ülkeler/bölgeler arasında İnternet üzerinden hata ayıklama önerilmez ve başarısız olabilir veya kabul edilemez düzeyde yavaş olabilir.
Uygulama IIS'de zaten çalışıyor mu?
Bu makale, Windows server'da IIS'nin temel yapılandırmasını ayarlama ve uygulamayı Visual Studio'dan dağıtma adımlarını içerir. Bu adımlar, sunucuda gerekli bileşenlerin yüklü olduğundan, uygulamanın doğru şekilde çalıştırıldığından ve uzaktan hata ayıklamaya hazır olduğunuzdan emin olmak için eklenmiştir.
Uygulamanız IIS'de çalışıyorsa ve yalnızca uzak hata ayıklayıcıyı indirip hata ayıklamayı başlatmak istiyorsanız, Windows Server'da uzak araçları indirme ve yükleme bölümüne gidin.
Hata ayıklamak için uygulamanızın IIS'de doğru şekilde ayarlandığından, dağıtıldığından ve çalıştığından emin olmak için yardım istiyorsanız, bu makaledeki tüm adımları izleyin.
Visual Studio bilgisayarında ASP.NET 4.8 uygulamasını oluşturma
Yeni bir MVC ASP.NET uygulaması oluşturun.
Visual Studio'da Dosya>Başlangıç penceresi'ni seçerek Başlangıç penceresini açın ve ardından Yeni proje oluştur'u seçin. Arama kutusuna asp.net çerçeve yazın ve ASP.NET Web Uygulaması (.NET Framework) öğesini seçin. Görüntülenen iletişim kutusunda projeyi MyASPApp olarak adlandırın, ASP.NET Framework 4.8'i seçin ve ardından Oluştur'u seçin.
MVC'yi ve ardından Oluştur'u seçin.
Denetleyiciler klasöründe HomeController.cs dosyasını açın ve yöntemindeki
return View;
deyimindePrivacy
bir kesme noktası ayarlayın.Eski şablonlarda Privacy.cshtml.cs dosyasını açın ve yönteminde
OnGet
bir kesme noktası ayarlayın.
Windows Server'da IIS Yükleme ve Yapılandırma
Bu adımlarda IIS'nin yalnızca temel yapılandırması gösterilir. Daha ayrıntılı bilgi edinmek veya bir Windows Masaüstü makinesine yüklemek için bkz. ASP.NET 3.5 ve ASP.NET 4.5 kullanarak IIS veya IIS 8.0'da yayımlama.
Windows Server işletim sistemleri için Yönet bağlantısı veya Sunucu Yöneticisi'daki Pano bağlantısı aracılığıyla Rol ve Özellik Ekleme sihirbazını kullanın. Sunucu Rolleri adımında Web Sunucusu (IIS) kutusunu işaretleyin.
(Windows Server 2022) Görüntülenen iletişim kutusunda Özellik Ekle'yi seçerek IIS Yönetim Konsolu'nu ekleyin.
Rol hizmetleri adımında, istediğiniz IIS rol hizmetlerini seçin veya sağlanan varsayılan rol hizmetlerini kabul edin. Yayımlama ayarlarını ve Web Dağıtımı'nı kullanarak dağıtımı etkinleştirmek istiyorsanız aşağıdaki özelliklerin seçili olduğundan emin olun:
- IIS Yönetim Betikleri ve Araçları
- Yönetim Hizmeti
- IIS Yönetim Konsolu
Web sunucusu rolünü ve hizmetlerini yüklemek için onay adımlarını izleyin. Web Sunucusu (IIS) rolü yüklendikten sonra sunucu/IIS yeniden başlatması gerekli değildir.
Windows Server'da tarayıcı güvenlik ayarlarını güncelleştirme
Windows Server'ın eski bir sürümünü kullanıyorsanız, bazı web sunucusu bileşenlerini indirmenizi sağlamak için bazı etki alanlarını güvenilen siteler olarak eklemeniz gerekebilir. İnternet Seçenekleri > Güvenlik Güvenilen Siteler Siteleri'ne giderek güvenilen siteleri> > ekleyin. Aşağıdaki etki alanlarını ekleyin.
- microsoft.com
- go.microsoft.com
- download.microsoft.com
- iis.net
Yazılımı indirdiğinizde, çeşitli web sitesi betiklerini ve kaynaklarını yükleme izni vermek için istekler alabilirsiniz. Bu kaynaklardan bazıları gerekli değildir, ancak işlemi basitleştirmek için sorulduğunda Ekle'yi seçin.
Windows Server'da ASP.NET 4.8'i yükleme
IIS'ye ASP.NET yüklemek için daha ayrıntılı bilgi istiyorsanız bkz . IIS 8.0 ASP.NET 3.5 ve ASP.NET 4.5 kullanma.
Not
Web Platformu Yükleyicisi 1/7/22 tarihinde Kullanım Süresi Sonuna ulaştı. Daha fazla bilgi için bkz . Web Platformu Yükleyicisi - Destek sonu ve ürün/uygulama akışını sıfırlama. IIS'den ASP.NET 4.8'i doğrudan yükleyebilirsiniz.
Sunucu Yöneticisi sol bölmesinde IIS'yi seçin. Sunucuya sağ tıklayın ve Rol ve Özellik Ekle'yi seçin.
Sihirbazda Özellikler bölümüne ilerleyin ve ASP.NET 4.8'i yükleyin.
Not
Windows Server 2008 R2 kullanıyorsanız, bunun yerine şu komutu kullanarak ASP.NET 4'ü yükleyin:
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -ir
Sistemi yeniden başlatın (veya sistem PATH'sinde bir değişiklik almak için komut isteminden net start w3svc'nin ardından /y komutunu yürütür).
Bir dağıtım seçeneği belirleme
Uygulamayı IIS'ye dağıtma konusunda yardıma ihtiyacınız varsa şu seçenekleri göz önünde bulundurun:
IIS'de yayımlama ayarları dosyası oluşturup Visual Studio'da ayarları içeri aktararak dağıtın. Bazı senaryolarda bu, uygulamanızı dağıtmanın hızlı bir yoludur. Yayımlama ayarları dosyasını oluşturduğunuzda, izinler IIS'de otomatik olarak ayarlanır.
Yerel bir klasöre yayımlayarak ve tercih edilen bir yöntemle çıktıyı IIS'de hazırlanmış bir uygulama klasörüne kopyalayarak dağıtın.
(İsteğe bağlı) Yayımlama ayarları dosyası kullanarak dağıtma
Yayımlama ayarları dosyası oluşturmak ve Visual Studio'ya aktarmak için bu seçeneği kullanabilirsiniz.
Not
Yayımlama ayarlarını içeri aktarmak yerine Web Dağıtımı'nı el ile yapılandırmak istiyorsanız, sunucudaki bir uygulama klasörünün doğru değer ve izinlerle yapılandırıldığından emin olmanız gerekir (bkz . ASP.NET Web sitesini yapılandırma).
Windows Server'da Web Dağıtımı yükleme ve yapılandırma
Web Dağıtımı, kullanıcı arabiriminden yayımlama ayarları dosyasının oluşturulmasını sağlayan ek yapılandırma özellikleri sağlar.
Not
Web Platformu Yükleyicisi 1/7/22 tarihinde Kullanım Süresi Sonuna ulaştı. Daha fazla bilgi için bkz . Web Platformu Yükleyicisi - Destek sonu ve ürün/uygulama akışını sıfırlama. Yayımlama ayarları dosyasını oluşturmak için Web Dağıtımı 4.0'ı doğrudan yükleyebilirsiniz.
IIS Yönetim Betikleri ve Araçları'nı henüz yüklemediyseniz şimdi yükleyin.
Sunucu rollerini>seçin Web Sunucusu (IIS)>Yönetim Araçları'na gidin ve IIS Yönetim Betikleri ve Araçları rolünü seçin, İleri'ye tıklayın ve ardından rolü yükleyin.
Yayımlama ayarları dosyasının oluşturulmasını etkinleştirmek için betikler ve araçlar gereklidir.
Yönetim Hizmeti'ni ve IIS Yönetim Konsolu'nu da yüklediğinizden emin olun (bunlar zaten yüklü olabilir).
Windows Server'da Web Dağıtımı 4.0'ı indirin.
Web Dağıtımı yükleme programını çalıştırın ve tipik bir yükleme yerine Yüklemeyi tamamla'yı seçtiğinizden emin olun.
Eksiksiz bir yüklemeyle, yayımlama ayarları dosyası oluşturmak için ihtiyacınız olan bileşenleri alırsınız. (İsterseniz Bunun yerine, aşağıdaki çizimde gösterildiği gibi bileşenlerin listesini görebilirsiniz.)
(İsteğe bağlı) Sistem ve Güvenlik Yönetim Araçları > Hizmetleri'Denetim Masası> açarak Web Dağıtımı'nın düzgün çalıştığını doğrulayın ve ardından şunları yaptığınızdan emin > olun:
Web Dağıtım Aracısı Hizmeti çalışıyor (hizmet adı eski sürümlerde farklıdır).
Web Yönetim Hizmeti çalışıyor.
Aracı hizmetlerinden biri çalışmıyorsa Web Dağıtım Aracısı Hizmeti'ni yeniden başlatın.
Web Dağıtım Aracısı Hizmeti hiç yoksa, Denetim Masası Programlar Program> kaldır'a gidin, Microsoft Web Dağıtımı <sürümünü> bulun. > Yüklemeyi değiştir'i seçin ve Web Dağıtımı bileşenleri için yerel sabit sürücüye yüklenecek seçeneğini belirlediğinizden emin olun. Değişiklik yükleme adımlarını tamamlayın.
Windows Server'da IIS'de yayımlama ayarları dosyasını oluşturma
Kullanıcı arabiriminde güncelleştirilmiş yapılandırma seçeneklerini göstermek için IIS Yönetim Konsolu'nu kapatıp yeniden açın.
IIS'de Varsayılan Web Sitesine sağ tıklayın, Dağıt>Web Dağıtımı Yayımlamayı Yapılandır'ı seçin.
Dağıt menüsünü görmüyorsanız, Web Dağıtımı'nın çalıştığını doğrulamak için önceki bölüme bakın.
Web Dağıtımı Yayımlamayı Yapılandır iletişim kutusunda ayarları inceleyin.
Kurulum’a tıklayın.
Sonuçlar panelinde çıkış, belirtilen kullanıcıya erişim haklarının verildiğini ve iletişim kutusunda gösterilen konumda .publishsettings dosya uzantısına sahip bir dosyanın oluşturulduğunu gösterir.
<?xml version="1.0" encoding="utf-8"?> <publishData> <publishProfile publishUrl="https://myhostname:8172/msdeploy.axd" msdeploySite="Default Web Site" destinationAppUrl="http://myhostname:80/" profileName="Default Settings" publishMethod="MSDeploy" userName="myhostname\myusername" /> </publishData>
Windows Server ve IIS yapılandırmanıza bağlı olarak, XML dosyasında farklı değerler görürsünüz. Gördüğünüz değerler hakkında birkaç ayrıntı aşağıdadır:
özniteliğinde başvuruda bulunılan
publishUrl
msdeploy.axd dosyası, Web Dağıtımı için dinamik olarak oluşturulmuş bir HTTP işleyici dosyasıdır. (Test amacıyla,http://myhostname:8172
genel olarak da çalışır.)Bağlantı
publishUrl
noktası, Web Dağıtımı için varsayılan olan 8172 numaralı bağlantı noktası olarak ayarlanır.Bağlantı
destinationAppUrl
noktası, IIS için varsayılan olan 80 numaralı bağlantı noktasına ayarlanır.Sonraki adımlarda konak adını kullanarak Visual Studio'dan uzak konağa bağlanamıyorsanız, ana bilgisayar adı yerine sunucunun IP adresini test edin.
Not
Azure VM üzerinde çalışan IIS'ye yayımlıyorsanız, Ağ Güvenliği grubunda Web Dağıtımı ve IIS için bir gelen bağlantı noktası açmanız gerekir. Ayrıntılı bilgi için bkz . Sanal makineye bağlantı noktalarını açma.
Bu dosyayı Visual Studio'yu çalıştırdığınız bilgisayara kopyalayın.
Visual Studio'da yayımlama ayarlarını içeri aktarma ve dağıtma
ASP.NET projesini Visual Studio'da açık olan bilgisayarda, Çözüm Gezgini'da projeye sağ tıklayın ve Yayımla'yı seçin.
Daha önce herhangi bir yayımlama profili yapılandırdıysanız Yayımla bölmesi görüntülenir. Yeni'ye veya Yeni profil oluştur'a tıklayın.
Bir profili içeri aktarma seçeneğini belirleyin.
Yayımla iletişim kutusunda Profili İçeri Aktar'a tıklayın.
Önceki bölümde oluşturduğunuz yayımlama ayarları dosyasının konumuna gidin.
Yayımlama Ayarları Dosyasını İçeri Aktar iletişim kutusunda, önceki bölümde oluşturduğunuz profile gidip seçin ve Aç'a tıklayın.
Yayımlama profilini kaydetmek için Son'a tıklayın ve ardından Yayımla'ya tıklayın.
Visual Studio dağıtım işlemini başlatır ve Çıkış penceresinde ilerleme ve sonuçlar gösterilir.
Herhangi bir dağıtım hatası alırsanız, ayarları düzenlemek için Diğer Eylemler>Düzenle'ye tıklayın. Yeni ayarları test etmek için ayarları değiştirin ve Doğrula'ya tıklayın. Ana bilgisayar adı bulunamazsa, hem Sunucu hem de Hedef URL alanlarında ana bilgisayar adı yerine IP adresini deneyin.
Uygulama başarıyla dağıtıldıktan sonra otomatik olarak başlatılmalıdır. Uygulama dağıtımdan sonra başlatılmıyorsa, doğru çalıştığını doğrulamak için uygulamayı IIS'de başlatın.
Hazır olduğunuzda hata ayıklama yapılandırmasına geçin.
Önemli
Yayın yapılandırmasında hata ayıklamayı seçerseniz, yayımladığınızda web.config dosyasında hata ayıklamayı devre dışı bırakırsınız.
- Profili düzenlemek için Diğer Seçenekler>Düzenle'yi ve ardından Ayarlar'ı seçin.
- Hata ayıklama yapılandırması'nı seçin ve ardından Dosya Yayımlama seçeneklerinin altında Hedefte ek dosyaları kaldır'ı seçin.
- Kaydet'i seçin ve uygulamayı yeniden yayımlayın.
- Profili düzenlemek için Düzenle'yi ve ardından Ayarlar'ı seçin.
- Hata ayıklama yapılandırması'nı seçin ve ardından Dosya Yayımlama seçeneklerinin altında Hedefte ek dosyaları kaldır'ı seçin.
- Kaydet'i seçin ve uygulamayı yeniden yayımlayın.
(İsteğe bağlı) Yerel bir klasöre yayımlayarak dağıtma
Uygulamayı PowerShell, RoboCopy kullanarak IIS'ye kopyalamak veya dosyaları el ile kopyalamak istiyorsanız, uygulamanızı dağıtmak için bu seçeneği kullanabilirsiniz.
Windows Server bilgisayarında ASP.NET Web sitesini yapılandırma
Windows Gezgini'ni açın ve daha sonra ASP.NET projesini dağıtacağınız C:\Publish adlı yeni bir klasör oluşturun.
Henüz açık değilse Internet Information Services (IIS) Yöneticisi'ni açın. (Sunucu Yöneticisi sol bölmesinde IIS'yi seçin. Sunucuya sağ tıklayın ve Internet Information Services (IIS) Yöneticisi'ni seçin.)
Sol bölmedeki Bağlantılar'ın altında Siteler'e gidin.
Varsayılan Web Sitesi'ni seçin, Temel Ayarlar'ı seçin ve Fiziksel yolu C:\Yayımla olarak ayarlayın.
Varsayılan Web Sitesi düğümüne sağ tıklayın ve Uygulama Ekle'yi seçin.
Diğer Ad alanını MyASPApp olarak ayarlayın, varsayılan Uygulama Havuzunu (DefaultAppPool) kabul edin ve Fiziksel yolu C:\Publish olarak ayarlayın.
Bağlantılar'ın altında Uygulama Havuzları'nı seçin. DefaultAppPool'u açın ve Uygulama havuzu alanını ASP.NET v4.0 olarak ayarlayın (ASP.NET 4.5, Uygulama havuzu için bir seçenek değildir).
IIS Yöneticisi'nde site seçiliyken İzinleri Düzenle'yi seçin ve IUSR, IIS_IUSRS veya Uygulama Havuzu için yapılandırılan kullanıcının Okuma ve Yürütme haklarına sahip yetkili bir kullanıcı olduğundan emin olun. Bu kullanıcıların hiçbiri yoksa, IUSR'yi Okuma ve Yürütme haklarına sahip bir kullanıcı olarak ekleyin.
Visual Studio'dan yerel bir klasöre yayımlayarak uygulamayı yayımlama ve dağıtma
Ayrıca, dosya sistemini veya diğer araçları kullanarak uygulamayı yayımlayabilir ve dağıtabilirsiniz.
ASP.NET 4.8 için web.config dosyasının doğru .NET sürümünü listelediğinden emin olun.
ASP.NET 4.8'i hedeflediyseniz, bu sürüm değerinin web.config dosyasında listelendiğinden emin olun:
<system.web> <compilation debug="true" targetFramework="4.8" /> <httpRuntime targetFramework="4.8" /> <httpModules> <add name="ApplicationInsightsWebTracking" type="Microsoft.ApplicationInsights.Web.ApplicationInsightsHttpModule, Microsoft.AI.Web" /> </httpModules> </system.web> ```
4.8 yerine ASP.NET 4'ü yüklerseniz, sürüm değeri web.config dosyasında 4.0 olarak belirtilmelidir.
Uygulamayı yayımlamak ve dağıtmak için şu adımları izleyin:
Çözüm Gezgini proje düğümüne sağ tıklayın ve Yayımla'yı seçin (Web Forms için, Web Uygulamasını Yayımla).
Daha önce herhangi bir yayımlama profili yapılandırdıysanız Yayımla bölmesi görüntülenir. Yeni profil'e tıklayın.
Yayımla iletişim kutusunda Klasör'e tıklayın, Gözat'a tıklayın ve C:\Publish adlı yeni bir klasör oluşturun.
Yayımlama profilini kaydetmek için Son'a tıklayın.
Yayımlama profilini kaydetmek için Son'a tıklayın.
Hata ayıklama yapılandırmasına geçin.
Profili düzenlemek için Düzenle'yi ve ardından Ayarlar'ı seçin. Bir Hata ayıklama yapılandırması seçin ve ardından Dosya Yayımlama seçenekleri altında Hedefte ek dosyaları kaldır'ı seçin.
Not
Yayın derlemesi kullanıyorsanız, yayımladığınızda web.config dosyasında hata ayıklamayı devre dışı bırakırsınız.
Yayımla öğesine tıklayın.
Uygulama, projenin hata ayıklama yapılandırmasını yerel klasöre yayımlar. İlerleme durumu Çıkış penceresinde gösterilir.
ASP.NET proje dizinini Visual Studio bilgisayarından Windows Server bilgisayarındaki ASP.NET uygulaması (bu örnekte C :\Publish) için yapılandırılan yerel dizine kopyalayın. Bu öğreticide, el ile kopyaladığınız varsayılır, ancak PowerShell, Xcopy veya Robocopy gibi diğer araçları kullanabilirsiniz.
Dikkat
Kodda veya yeniden derlemede değişiklik yapmanız gerekiyorsa, bu adımı yeniden yayımlamanız ve yinelemeniz gerekir. Uzak makineye kopyaladığınız yürütülebilir dosya yerel kaynağınızla ve sembollerinizle tam olarak eşleşmelidir. Bunu yapmazsanız, işlemde hata ayıklamayı denediğinizde Visual Studio'da bir
cannot find or open the PDB file
uyarı alırsınız.Windows Server'da, uygulamayı tarayıcınızda açarak uygulamayı doğru çalıştırabildiğinizi doğrulayın.
Uygulama düzgün çalışmazsa, sunucunuzda yüklü ASP.NET sürümüyle Visual Studio makineniz arasında bir uyuşmazlık olabilir veya IIS veya Web sitesi yapılandırmanızla ilgili bir sorun olabilir. Önceki adımları yeniden denetleyin.
Windows Server'da uzak araçları indirme ve yükleme
Uzak araçların Visual Studio sürümünüzle eşleşen sürümünü indirin.
Visual Studio makinesi yerine hata ayıklamak istediğiniz uzak cihazda veya sunucuda, aşağıdaki tablodaki bağlantılardan uzak araçların doğru sürümünü indirin ve yükleyin.
- Visual Studio sürümünüz için uzak araçların en son güncelleştirmesini indirin. Önceki uzak araçlar sürümleri, sonraki Visual Studio sürümleriyle uyumlu değildir. (Örneğin, Visual Studio 2019 kullanıyorsanız Visual Studio 2019 için uzak araçların en son güncelleştirmesini indirin. Bu senaryoda Visual Studio 2022 için uzak araçları indirmeyin.)
- Yüklemekte olduğunuz makineyle aynı mimariye sahip uzak araçları indirin. Örneğin, x64 işletim sistemi çalıştıran uzak bir bilgisayarda x86 uygulamalarında hata ayıklamak istiyorsanız, x64 uzak araçlarını yükleyin. ARM64 işletim sisteminde x86, ARM veya x64 uygulamalarında hata ayıklamak için ARM64 uzak araçlarını yükleyin.
Sürüm | Bağlantı | Notlar |
---|---|---|
Visual Studio 2022 | Uzak araçlar | Tüm Visual Studio 2022 sürümleriyle uyumludur. Cihazınızın işletim sistemiyle eşleşen sürümü indirin (x86, x64 (AMD64) veya ARM64). Windows Server'ın eski sürümlerinde, uzak araçları indirme konusunda yardım için dosya indirme engellemesini kaldırma bölümüne bakın. |
Visual Studio 2019 | Uzak araçlar | Visual Studio 2019 için uzak araçlar My.VisualStudio.com'den edinilebilir. İstenirse ücretsiz Visual Studio Dev Essentials programına katılın veya Visual Studio abonelik kimliğiniz ile oturum açın. Cihazınızın işletim sistemiyle eşleşen sürümü indirin (x86, x64 (AMD64) veya ARM64). Windows Server'ın eski sürümlerinde, uzak araçları indirme konusunda yardım için dosya indirme engellemesini kaldırma bölümüne bakın. |
Visual Studio 2017 | Uzak araçlar | Visual Studio 2017 için uzak araçlar My.VisualStudio.com'den edinilebilir. İstenirse ücretsiz Visual Studio Dev Essentials programına katılın veya Visual Studio abonelik kimliğiniz ile oturum açın. Cihazınızın işletim sistemiyle eşleşen sürümü indirin (x86, x64 (AMD64) veya ARM64). Windows Server'da, uzak araçları indirme konusunda yardım için dosya indirme engellemesini kaldırma bölümüne bakın. |
Visual Studio 2015 | Uzak araçlar | Visual Studio 2015 için uzak araçlar My.VisualStudio.com'den edinilebilir. İstenirse ücretsiz Visual Studio Dev Essentials programına katılın veya Visual Studio abonelik kimliğiniz ile oturum açın. Windows Server'da, uzak araçları indirme konusunda yardım için dosya indirme engellemesini kaldırma bölümüne bakın. |
Visual Studio 2013 | Uzak araçlar | Visual Studio 2013 belgelerinde indirme sayfası |
Visual Studio 2012 | Uzak araçlar | Visual Studio 2012 belgelerinde indirme sayfası |
Sürüm | Bağlantı | Notlar |
---|---|---|
Visual Studio 2019 | Uzak araçlar | Tüm Visual Studio 2019 sürümleriyle uyumludur. Cihazınızın işletim sistemiyle eşleşen sürümü indirin (x86, x64 (AMD64) veya ARM64). Windows Server'da, uzak araçları indirme konusunda yardım için dosya indirme engellemesini kaldırma bölümüne bakın. Uzak araçların en son sürümü için Visual Studio 2022 belgesini açın. |
Visual Studio 2017 | Uzak araçlar | Tüm Visual Studio 2017 sürümleriyle uyumludur. Cihazınızın işletim sistemiyle eşleşen sürümü indirin (x86, x64 (AMD64) veya ARM64). Windows Server'da, uzak araçları indirme konusunda yardım için dosya indirme engellemesini kaldırma bölümüne bakın. |
Visual Studio 2015 | Uzak araçlar | Visual Studio 2015 için uzak araçlar My.VisualStudio.com'den edinilebilir. İstenirse ücretsiz Visual Studio Dev Essentials programına katılın veya Visual Studio abonelik kimliğiniz ile oturum açın. Windows Server'da, uzak araçları indirme konusunda yardım için dosya indirme engellemesini kaldırma bölümüne bakın. |
Visual Studio 2013 | Uzak araçlar | Visual Studio 2013 belgelerinde indirme sayfası |
Visual Studio 2012 | Uzak araçlar | Visual Studio 2012 belgelerinde indirme sayfası |
Uzak araçları yüklemek yerine uzak bilgisayara msvsmon.exe kopyalayarak uzak hata ayıklayıcısını çalıştırabilirsiniz. Ancak, Uzak Hata Ayıklayıcı Yapılandırma Sihirbazı (rdbgwiz.exe) yalnızca uzak araçları yüklediğinizde kullanılabilir. Uzaktan hata ayıklayıcısını hizmet olarak çalıştırmak istiyorsanız yapılandırma için sihirbazı kullanmanız gerekebilir. Daha fazla bilgi için bkz . (İsteğe bağlı) Uzak hata ayıklayıcıyı hizmet olarak yapılandırma.
Not
- ARM cihazlarında Windows 10 veya üzeri uygulamalarda hata ayıklamak için, uzak araçların en son sürümüyle kullanılabilen ARM64'i kullanın.
- Windows RT cihazlarında Windows 10 uygulamalarında hata ayıklamak için, yalnızca Visual Studio 2015 uzak araçları indirmesinde kullanılabilen ARM'yi kullanın.
- ARM64 işletim sistemindeki x64 uygulamalarında hata ayıklamak için ARM64 uzak araçlarıyla yüklenen x64 msvsmon.exe çalıştırın.
Windows Server'da uzak hata ayıklayıcıyı ayarlama
Uzak bilgisayarda, Başlat menüsünden Uzaktan Hata Ayıklayıcı'yı bulun ve başlatın.
Uzak bilgisayarda yönetici izinleriniz yoksa, Uzak Hata Ayıklayıcı uygulamasına sağ tıklayın ve Yönetici olarak çalıştır'ı seçin. Aksi takdirde, normal bir şekilde başlatın.
Yönetici olarak çalışan veya farklı bir kullanıcı hesabı (IIS gibi) altında çalışan bir işleme ekleme yapmayı planlıyorsanız, Uzaktan Hata Ayıklayıcı uygulamasına sağ tıklayın ve Yönetici olarak çalıştır'ı seçin. Daha fazla bilgi için bkz . Uzak hata ayıklayıcıyı yönetici olarak çalıştırma.
Uzak hata ayıklayıcıyı ilk kez başlattığınızda (veya yapılandırmadan önce), Uzaktan Hata Ayıklama Yapılandırma sihirbazı görüntülenir.
Çoğu senaryoda, sihirbazın Windows Güvenlik Duvarını Yapılandır sayfasına gelene kadar İleri'yi seçin.
Yalnızca Windows Server 2008 R2'de gerçekleşen Windows Web Hizmetleri API'si yüklü değilse Yükle düğmesini seçin.
Uzak araçları kullanmak istediğiniz en az bir ağ türü seçin. Bilgisayarlar bir etki alanı üzerinden bağlıysa, ilk öğeyi seçmeniz gerekir. Bilgisayarlar bir çalışma grubu veya ev grubu aracılığıyla bağlıysa, ikinci veya üçüncü öğeyi uygun şekilde seçin.
Ardından, uzak hata ayıklayıcıyı başlatmak için Son'u seçin.
Ardından, uzaktan hata ayıklayıcıyı başlatmak için Uzaktan hata ayıklamayı yapılandır'ı seçin.
Yapılandırma tamamlandığında, Uzak Hata Ayıklayıcı penceresi görüntülenir.
Uzak hata ayıklayıcı şimdi bağlantı bekliyor. Visual Studio'da uzak bağlantı yapılandırmasını ayarlamak için gösterilen sunucu adını ve bağlantı noktası numarasını kullanın.
Uzak hata ayıklayıcıyı durdurmak için Dosyadan>Çık'ı seçin. Başlat menüsünden veya komut satırından yeniden başlatabilirsiniz:
<Remote debugger installation directory>\msvsmon.exe
Not
Ek kullanıcılar için izin eklemeniz, kimlik doğrulama modunu veya uzak hata ayıklayıcının bağlantı noktası numarasını değiştirmeniz gerekiyorsa bkz . Uzak hata ayıklayıcıyı yapılandırma.
Uzak hata ayıklayıcıyı hizmet olarak çalıştırma hakkında bilgi için bkz . Uzak hata ayıklayıcıyı hizmet olarak çalıştırma.
Visual Studio bilgisayarından ASP.NET uygulamasına ekleme
Visual Studio 2022 sürüm 17.10 Preview 2'den başlayarak İşleme Ekle iletişim kutusu değişti. Eski iletişim kutusuyla eşleşen yönergelere ihtiyacınız varsa Visual Studio 2019 görünümüne geçin (makalede sol üst sürüm seçicisi).
Visual Studio bilgisayarında, hata ayıklamaya çalıştığınız çözümü açın (bu makaledeki tüm adımları izliyorsanız MyASPApp ).
Visual Studio'da İşleme Ekleme Hatalarını Ayıkla > (Ctrl + Alt + P) seçeneğini belirleyin.
İpucu
Visual Studio 2017 ve sonraki sürümlerde, İşleme Yeniden Ekleme Hatalarını Ayıkla>... (Shift + Alt + P) kullanarak daha önce eklediğiniz işleme yeniden bağlanabilirsiniz.
Bağlantı Türü'nü Uzak (Windows) olarak ayarlayın.
Bağlantı Hedefi seçeneği görüntülenir.
Bağlantı Hedefi'ni uzak bilgisayar adı> olarak< ayarlayın ve Enter tuşuna basın.
Visual Studio'nun gerekli bağlantı noktasını bilgisayar adına eklediğini doğrulayın; bu bağlantı noktası şu biçimde görünür: <uzak bilgisayar adı>:p ort
Visual Studio 2022'de uzak bilgisayar adı>:4026'yı görmeniz gerekir <
Bağlantı noktası gereklidir. Bağlantı noktası numarasını görmüyorsanız el ile ekleyin.
Visual Studio bilgisayarında, hata ayıklamaya çalıştığınız çözümü açın (bu makaledeki tüm adımları izliyorsanız MyASPApp ).
Visual Studio'da İşleme Ekleme Hatalarını Ayıkla > (Ctrl + Alt + P) seçeneğini belirleyin.
İpucu
Visual Studio 2017 ve sonraki sürümlerde, İşleme Yeniden Ekleme Hatalarını Ayıkla>... (Shift + Alt + P) kullanarak daha önce eklediğiniz işleme yeniden bağlanabilirsiniz.
Niteleyici alanını uzak bilgisayar adı> olarak <ayarlayın ve Enter tuşuna basın.
Visual Studio'nun gerekli bağlantı noktasını bilgisayar adına eklediğini doğrulayın; bu bağlantı noktası şu biçimde görünür: <uzak bilgisayar adı>:p ort
Visual Studio 2019'da uzak bilgisayar adını> görmeniz <gerekir:4024
Bağlantı noktası gereklidir. Bağlantı noktası numarasını görmüyorsanız el ile ekleyin.
Yenile'yi seçin.
Kullanılabilir İşlemler penceresinde bazı işlemlerin göründüğünü görmeniz gerekir.
Herhangi bir işlem görmüyorsanız uzak bilgisayar adı yerine IP adresini kullanmayı deneyin (bağlantı noktası gereklidir). IPv4 adresini almak için komut satırında kullanabilirsiniz
ipconfig
.Bul düğmesini kullanmak istiyorsanız, sunucuda giden UDP bağlantı noktası 3702'yi açmanız gerekebilir.
Tüm kullanıcılardan gelen işlemleri göster'i işaretleyin.
ASP.NET 4.5 için w3wp.exe hızla bulmak için işlem adının ilk harfini yazın.
w3wp.exe gösteren birden çok işleminiz varsa Kullanıcı Adı sütununu denetleyin. Bazı senaryolarda, Kullanıcı Adı sütunu IIS APPPOOL\DefaultAppPool gibi uygulama havuzu adınızı gösterir. Uygulama Havuzunu görüyorsanız, doğru işlemi tanımlamanın kolay bir yolu, hata ayıklamak istediğiniz uygulama örneği için yeni bir adlandırılmış Uygulama Havuzu oluşturmaktır ve bunu Kullanıcı Adı sütununda kolayca bulabilirsiniz.
İliştir'i seçin.
Uzak bilgisayarın web sitesini açın. Tarayıcıda http://< remote bilgisayar adı'na> gidin.
ASP.NET web sayfasını görmeniz gerekir.
Çalışan ASP.NET uygulamasında Gizlilik sayfasının bağlantısını seçin.
Visual Studio'da kesme noktasına isabet edilmelidir.
Kesme noktasını ekleyemiyor veya isabet edemiyorsanız bkz . Uzaktan hata ayıklama sorunlarını giderme.
IIS dağıtımı sorunlarını giderme
- Ana bilgisayar adını kullanarak konağa bağlanamıyorsanız, bunun yerine IP adresini deneyin.
- Uzak sunucuda gerekli bağlantı noktalarının açık olduğundan emin olun.
- Uygulamanızda kullanılan ASP.NET sürümünün sunucuya yüklediğiniz sürümle aynı olduğunu doğrulayın. Uygulamanız için, Özellikler sayfasında sürümü görüntüleyebilir ve ayarlayabilirsiniz. Uygulamayı farklı bir sürüme ayarlamak için bu sürümün yüklü olması gerekir.
- Uygulama açılmaya çalışsa da bir sertifika uyarısı görürseniz siteye güvenmeyi seçin. Uyarıyı zaten kapattıysanız, projenizde bir *.pubxml dosyası olan yayımlama profilini düzenleyebilir ve aşağıdaki öğeyi ekleyebilirsiniz (yalnızca test için):
<AllowUntrustedCertificate>true</AllowUntrustedCertificate>
- Dağıtıldıktan sonra, doğru dağıtıldığını test etmek için uygulamayı IIS'de başlatın.
- Durum bilgileri için Visual Studio'da Çıkış penceresine bakın ve hata iletilerinizi denetleyin.
Windows Server'da gerekli bağlantı noktalarını açma
Çoğu kurulumda, gerekli bağlantı noktaları ASP.NET ve uzak hata ayıklayıcı yüklemesi tarafından açılır. Ancak, bağlantı noktalarının açık olduğunu doğrulamanız gerekebilir.
Not
Azure VM'sinde bağlantı noktalarını Ağ güvenlik grubu aracılığıyla açmanız gerekir.
Gerekli bağlantı noktaları:
- 80: IIS için gereklidir.
- 4026: Visual Studio 2022'den uzaktan hata ayıklama için gereklidir (daha fazla bilgi için bkz . Uzak Hata Ayıklayıcı Bağlantı Noktası Atamaları ).
4024: Visual Studio 2019'dan uzaktan hata ayıklama için gereklidir (daha fazla bilgi için bkz . Uzaktan Hata Ayıklayıcı Bağlantı Noktası Atamaları ).
UDP 3702: (İsteğe bağlı) Bulma bağlantı noktası, Visual Studio'da uzak hata ayıklayıcıya eklerken Bul düğmesine bağlanmanızı sağlar.
Ayrıca, bu bağlantı noktaları ASP.NET yüklemesi tarafından zaten açılmalıdır:
- 8172: (İsteğe bağlı) Uygulamayı Visual Studio'dan dağıtmak için Web Dağıtımı gereklidir.
Bağlantı noktası açma
Windows Server'da bir bağlantı noktası açmak için Başlat menüsünü açın, Windows Defender Güvenlik Duvarı'nı veya Gelişmiş Güvenlik özellikli Windows Güvenlik Duvarı'nı arayın.
Windows Defender Güvenlik Duvarı için Gelişmiş ayarlar'ı seçin.
Ardından Gelen Kuralları > Yeni Kural > Bağlantı Noktası'nı seçin. İleri'yi seçin ve Belirli yerel bağlantı noktaları'nın altında bağlantı noktası numarasını girin, İleri'yi ve ardından Bağlantıya İzin Ver'i seçin, İleri'yi seçin ve Gelen Kuralı için adı (IIS, Web Dağıtımı veya msvsmon) ekleyin.
Windows Güvenlik Duvarı'nı yapılandırma hakkında daha fazla ayrıntı istiyorsanız bkz . Windows Güvenlik Duvarı'nı Uzaktan Hata Ayıklama için Yapılandırma.
Diğer gerekli bağlantı noktaları için daha fazla kural oluşturun.