Visual Studio'ASP.NET Core Azure'da IIS'de Uzaktan Hata Ayıklama Visual Studio
Bu kılavuzda bir Visual Studio ASP.NET Core uygulamasını ayarlama ve yapılandırma, Azure kullanarak IIS'ye dağıtma ve uzaktan hata ayıklayıcıyı Visual Studio.
IIS senaryoları için Linux desteklenmiyor.
Azure'da uzaktan hata ayıklama için önerilen yol senaryonıza bağlıdır:
Sanal ağlarda ASP.NET Core ayıklamak Azure App Service bkz. azure uygulamalarını kullanarak Snapshot Debugger. Bu önerilen yöntemdir.
Daha geleneksel hata ASP.NET Core kullanarak Azure App Service hata ayıklamada hata ayıklamak için bu konudaki adımları izleyin (Azure App Service üzerinde uzaktan hata ayıklama).
Bu senaryoda, uygulamanızı Visual Studio'den Azure'a dağıtmanız gerekir, ancak aşağıdaki çizimde gösterildiği gibi IIS'yi veya uzak hata ayıklayıcısını (bu bileşenler noktalı satırlarla gösterilir) el ile yüklemeniz veya yapılandırmanız gerekmez.

Azure VM'sinde IIS'de hata ayıklamak için bu konudaki adımları izleyin (Azure VM'de UzaktanHata Ayıklama bölümüne bakın). Bu, IIS'nin özelleştirilmiş bir yapılandırmasını kullanmanızı sağlar, ancak kurulum ve dağıtım adımları daha karmaşıktır.
Bir Azure VM için uygulamanızı Visual Studio Azure'a dağıtmanız ve ayrıca aşağıdaki çizimde gösterildiği gibi IIS rolünü ve uzaktan hata ayıklayıcıyı el ile yüklemeniz gerekir.

Azure ASP.NET Core'Service Fabric hata ayıklamak için bkz. Uzak Service Fabric hata ayıklama.
Uyarı
Bu öğreticide yer alan adımları tamamlayan azure kaynaklarını silebilirsiniz. Bu sayede gereksiz ücretlerden kaçınarak ücret ödemezsiniz.
Önkoşullar
Visual Studio 2019 veya sonraki sürümlerin bu makalede gösterilen adımları izlemesi gerekir.
Visual Studio makalede gösterilen adımları takip etmek için 2017'ye bakın.
Ağ gereksinimleri
Ara sunucu üzerinden bağlanan iki bilgisayar arasında hata ayıklama desteklenmiyor. Çevirmeli İnternet gibi yüksek gecikme süresi veya düşük bant genişliği bağlantısı üzerinden veya ülkeler arasında İnternet üzerinden hata ayıklama önerilmez ve başarısız olabilir veya kabul edilemez düzeyde yavaş olabilir. Gereksinimlerin tam listesi için bkz. Gereksinimler.
ASP.NET Core bilgisayarda Visual Studio oluşturma
Yeni bir web ASP.NET Core oluşturun.
2019 Visual Studio da başlangıç penceresinde Yeni proje oluştur'a tıklayın. Başlangıç penceresi açık değilse Dosya Başlangıç Penceresi'ne > tıklayın. Web uygulaması yazın, dil olarak C# seçin, ardından ASP.NET Core Web Uygulaması (Model-Görünüm-Denetleyici) ve ardından Sonraki'yi seçin. Sonraki ekranda projeye MyASPApp adını ve ardından Sonraki'yi seçin.
Önerilen hedef çerçeveyi veya .NET 6'yi seçin ve ardından Oluştur'a seçin.
2017 Visual Studio de Dosya > Yeni> Project'ı ve ardından Visual C# > Web Uygulaması'> ASP.NET Core seçin. Uygulama şablonları ASP.NET Core Web Uygulaması (Model-View-Controller) öğesini seçin. 2.1 ASP.NET Core veya sonraki bir sonraki bir dosyanın seçili olduğundan, Docker Desteğini Etkinleştir'in seçili olduğundan ve Kimlik Doğrulaması Yok olarak ayarlanmış olduğundan emin olun. Projeye MyASPApp adını girin.
About.cshtml.cs dosyasını açın ve yönteminde bir kesme noktası ayarlayın (eski şablonlarda bunun yerine HomeController.cs dosyasını açın ve yönteminde
OnGetkesme noktasıAbout()ayarlayın).
Bir Azure App Service ASP.NET Core Uzaktan Hata Ayıklama (Windows)
Bu Visual Studio, tam olarak sağlanan bir IIS örneğini temel alan Azure App Service Windows uygulamanıza hızla yayımlayın ve hata ayıklayın. BIR VM'de IIS barındırıyorsanız, Azure VM'de hata ayıklamayı deneyin.)
Yayımla penceresini kullanarak Azure App Service yayımlama profili oluşturun.
Profilde Barındırma altında ... menüsünü seçin. Hata Ayıklayıcı ekle seçeneğini belirleyin.
Visual Studio, uzaktan hata ayıklayıcıyı profilin yayım Azure App Service (Windows) örneğine eklemeye çalışır.
Not
2022 Visual Studio de, Cloud Explorer kullanım dışıdır. Cloud Explorer, uzaktan hata ayıklamanın önceki yöntemini Azure App Service.
Cloud Explorer kullanarak uygulamayı ve uzaktan hata ayıklamayı dağıtmak için
Bu Visual Studio proje düğümüne 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 veya Yeni profil'i seçin.
Yeni bir yayımlama profili oluşturun.
Yayımla iletişim kutusundan Azure'ı seçin ve Ardından'yı seçin. Ardından Azure App Service (Windows) öğesini seçin, Sonraki'yi seçin ve istemleri takip edin ve profil oluşturun.

2017 Visual Studio de Yayımla iletişim kutusundan Azure App Service'yi seçin, Yeni Oluştur'a tıklayın ve profil oluşturmak için istemleri izleyin.
Daha ayrıntılı yönergeler için bkz. ASP.NET Core kullanarak Azure'a bir web Visual Studio.
Yayımla penceresinde Yapılandırmayı Düzenle'yi seçin, bir Hata ayıklama yapılandırmasına geçiş ve ardından Yayımla'yı seçin.
Uygulamada hata ayıklamak için hata ayıklama yapılandırması gerekir.
Bulut Gezgini 'ni (Bulut > Gezginini Görüntüle) açın, App Service'ye sağ tıklayın ve Hata Ayıklayıcı Ekle'yi seçin.
Bulut Gezgini kullanılamıyorsa, bunun yerine Sunucu Gezgini açın. Ardından, App Service'daki App Service sağ tıklayın ve Sunucu Gezgini Ekle'yi seçin.
Çalışan ASP.NET sayfasında Hakkında sayfasına tıklayın.
Kesme noktası, Visual Studio.
İşte bu kadar! Bu konudaki adımların geri kalanı Azure VM'sinde uzaktan hata ayıklama için geçerlidir.
Azure VM'ASP.NET Core Uzaktan Hata Ayıklama
Windows Server için bir Azure VM oluşturabilir ve ardından IIS'yi ve diğer gerekli yazılım bileşenlerini yükleyebilir ve yapılandırabilirsiniz. Bu işlem, bir dağıtım Azure App Service daha uzun sürer ve bu öğreticide kalan adımları izlemesini gerektirir.
Bu yordamlar şu sunucu yapılandırmalarında test edilmiştir:
- Windows Server 2012 R2 ve IIS 8
- Windows Server 2016 ve IIS 10
- Windows Server 2019 ve IIS 10
Uygulama Zaten Azure VM'de IIS'de mi çalışıyor?
Bu makale, Windows sunucusunda IIS'nin temel yapılandırmasını ayarlama ve uygulamayı Visual Studio. Bu adımlar, sunucuda gerekli bileşenlerin yüklü olduğundan, uygulamanın doğru şekilde çalıştırılaya kadar olduğundan ve uzaktan hata ayıklamaya hazır olduğundan emin olmak için dahil edilir.
Uygulamanız IIS'de çalışıyorsa ve yalnızca uzak hata ayıklayıcısını indirmek ve hata ayıklamayı başlatmak için Uzak araçları İndirme ve Yükleme 'ye gidin Windows Server.
Hata ayıklamak için, uygulamanın IIS'de doğru şekilde ayarıldığından, dağıtıldığından ve çalıştırıldığından emin olmak için yardım almak için bu konudaki tüm adımları izleyin.
Başlamadan önce, IIS web sunucusunu yükleme adımlarını içeren WindowsSanal Makine Oluşturma altında açıklanan tüm adımları izleyin.
80 bağlantı noktasını Azure Ağ güvenlik grubunda açık olduğundan emin olun. 80 bağlantı noktasının açık olduğunu doğrularken, uzak hata ayıklayıcısı (4026, 4024 veya 4022) için de doğru bağlantı noktasını açın. Bu şekilde, daha sonra açmak zorunda olmayacaktır. Web Dağıtımı 8172 bağlantı noktasını da açın.
Windows Server'da tarayıcı güvenlik ayarlarını güncelleştirme
Internet Explorer'da Gelişmiş Güvenlik Yapılandırması etkinleştirildiyse (varsayılan olarak etkindir), bazı web sunucusu bileşenlerini indirmenizi sağlamak için bazı etki alanlarını güvenilen siteler olarak eklemeniz gerekir. Güvenilen Siteler ve Siteleri için İnternet Seçenekleri'ne > Güvenlik > sitelere > ekleyin. Aşağıdaki etki alanlarını ekleyin.
- microsoft.com
- go.microsoft.com
- download.microsoft.com
- iis.net
Yazılımı indirirken, çeşitli web sitesi betiklerini ve kaynaklarını yükleme izni vermek için istekler edinebilirsiniz. Bu kaynakların bazıları gerekli değildir, ancak işlemi basitleştirmek için istendiğinde Ekle'ye tıklayın.
ASP.NET Core Server'Windows yükleme
.NET Core Barındırma Paketi'nin barındırma sistemine yükleyin. Paket. .NET Core Çalışma Zamanı, .NET Core Kitaplığı ve ASP.NET Core Modülü'ASP.NET Core yüklenir. Daha ayrıntılı yönergeler için bkz. IIS'de yayımlama.
Geçerli .NET Core barındırma paketi için, ASP.NET Core Paketi'ne yükleyin. .NET Core 2 için .NET Core'Windows Sunucu Barındırma'ya yükleyin.
Not
Sistemin İnternet bağlantısı yoksa, .NET Core Windows Server Hosting paketi yüklemeden önce Microsoft Visual C++ 2015 Yeniden Dağıtılabilir'i alın ve yükleyin.
Sistemi yeniden başlatın (veya sistem YOLUNDA bir değişiklik almak için bir komut isteminden net start w3svc ve ardından net start w3svc) net stop komutunu yürütün.
Dağıtım seçeneği belirtin
Uygulamayı IIS'ye dağıtmak için yardıma ihtiyacınız varsa şu seçenekleri göz önünde bulun:
IIS'de yayımlama ayarları dosyası oluşturarak ve ayarları iis'te içeri aktararak Visual Studio. Bazı senaryolarda bu, uygulamanızı dağıtmanın hızlı bir yoludur. Yayımlama ayarları dosyasını sanız, izinler IIS'de otomatik olarak ayarlanır.
Dağıtımı yerel bir klasöre yayımlayıp tercih edilen bir yöntem tarafından IIS'de hazırlanmış bir uygulama klasörüne kopyalayıp dağıtın.
(İsteğe bağlı) Yayımlama ayarları dosyası kullanarak dağıtma
Bu seçeneği kullanarak bir yayımlama ayarları dosyası oluşturabilir ve dosyayı Visual Studio.
Not
Bu dağıtım yöntemi Web Dağıtımı sunucuda yüklü olması gereken bir uygulama kullanır. Ayarları içeri aktarma Web Dağıtımı el ile yapılandırmak için, Barındırma Sunucuları için Web Dağıtımı 3.6 yerine Web Dağıtımı 3.6'Web Dağıtımı yükleyebilirsiniz. Ancak, sunucuyu Web Dağıtımı yapılandırdıysanız, sunucusundaki bir uygulama klasörünün doğru değer ve izinlerle yapılandırıldığından emin ASP.NET gerekir.
ASP.NET Core web sitesini yapılandırma
IIS Yöneticisi'nde, sol bölmede Bağlantılar'ın altında Uygulama Havuzları'nı seçin. DefaultAppPool'ı açın ve .NET CLR sürümünü Yönetilen Kod Yok olarak ayarlayın. Bu, ASP.NET Core. Varsayılan Web Sitesi DefaultAppPool kullanır.
DefaultAppPool'u durdurun ve yeniden başlatın.
Windows Server'da Barındırma Sunucuları için Web Dağıtımı yükleme ve yapılandırma
Barındırma sunucuları için Web Dağıtımı 3,6, kullanıcı arabiriminden yayımlama ayarları dosyası oluşturulmasına olanak tanıyan ek yapılandırma özellikleri sağlar.
IIS için Web Platformu Yükleyicisi, bu makalede önerdiğimiz sürüm olan 4,0 değil, sürüm 3,6 ' in yüklenmesine izin verir.
Windows sunucuda zaten yüklü Web Dağıtımı varsa, denetim masası programları ' nı kullanarak > > programı kaldırın.
sonra, Windows sunucusundaki barındırma sunucuları için Web Dağıtımı 3,6 ' ü yükler.
Barındırma sunucularına yönelik Web Dağıtımı yüklemek için Web Platformu Yükleyicisi (WebPI) kullanın. (Web Platformu Yükleyicisi bağlantısını IIS 'den bulmak için, Sunucu Yöneticisi sol bölmesinde IIS ' yi seçin. sunucu bölmesinde, sunucuya sağ tıklayın ve Internet Information Services (ııs) yöneticisi' ni seçin. Ardından Eylemler penceresinde Yeni Web Platformu bileşenlerini al bağlantısını kullanın.) Web Platformu Yükleyicisi 'ni (WebPI) indirmelerdende edinebilirsiniz.
Web platformu yükleyicisinde, uygulamalar sekmesinde barındırma sunucuları için Web Dağıtımı 3,6 ' i bulabilirsiniz.
Daha önce IIS Yönetim betikleri ve araçları yüklemediyseniz, şimdi yükleyebilirsiniz.
Sunucu rolleri > Web sunucusu (IIS) > Yönetim Araçları' nı seçin ve ardından IIS Yönetim betikleri ve araçları rolünü seçin, İleri' ye tıklayın ve ardından rolü yükler.

Yayımlama ayarları dosyasının oluşturulmasını sağlamak için betikler ve araçlar gereklidir.
Seçim Denetim masası > sistem ve güvenlik > yönetim araçları > Hizmetleri' ni açarak Web dağıtımı doğru şekilde çalıştığını doğrulayın ve aşağıdakileri yaptığınızdan emin olun:
Web Deployment Agent hizmeti çalışıyor (hizmet adı eski sürümlerde farklı).
Web yönetimi hizmeti çalışıyor.
aracı hizmetlerinden biri çalışmıyorsa, Web Deployment Agent hizmetini yeniden başlatın.
Web Deployment Agent hizmeti hiç yoksa, denetim masası > programlar > bir programı kaldır ' a gidin, Microsoft Web Dağıtımı <version> bulun. Yüklemeyi değiştirmeyi seçin ve Web dağıtımı bileşenleri için yerel sabit diske yüklenediğinizden emin olun. Değişiklik yükleme adımlarını doldurun.
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ın ve yeniden açın.
IIS'de, Varsayılan Web Sitesi'ne sağ tıklayın, Dağıtımı Yapılandır'ı Yayımlama > Web Dağıtımı seçin.

Dağıt menüsünü görmüyorsanız, uygulamanın çalıştığını doğrulamak için önceki Web Dağıtımı bakın.
Yayımlamayı Web Dağıtımı iletişim kutusunda ayarları inceleme.
Kurulum'a tıklayın.
Sonuçlar panelinde çıkış, belirtilen kullanıcıya erişim haklarının verilmiş olduğunu ve iletişim kutusunda gösterilen konumda .publishsettings dosya uzantısına sahip bir dosyanın oluşturulup oluşturulmamış olduğ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/" mySQLDBConnectionString="" SQLServerDBConnectionString="" 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üyorsunuz. Gördüğünüz değerler hakkında birkaç ayrıntı:
özniteliğinde başvurulan msdeploy.axd dosyası, bu dosya için dinamik olarak oluşturulan
publishUrlbir HTTP Web Dağıtımı. (Test amacıyla genelhttp://myhostname:8172olarak da çalışır.)Bağlantı noktası, 8172 bağlantı noktası olarak ayarlanır ve bu
publishUrlbağlantı noktası 8172 Web Dağıtımı.Bağlantı
destinationAppUrlnoktası, IIS için varsayılan değer olan 80 bağlantı noktası olarak ayarlanır.Sonraki adımlarda ana bilgisayar adını kullanarak uzak Visual Studio bağlanamıyorsanız, ana bilgisayar adı yerine sunucunun IP adresini test edin.
Not
Bir Azure VM üzerinde çalışan IIS'ye yayımlarsanız, Ağ Güvenlik grubunda Web Dağıtımı IIS için bir gelen bağlantı noktası açabilirsiniz. Ayrıntılı bilgi için bkz. Bağlantı noktalarını sanal makineye açma.
Bu dosyayı, dosyanın çalıştır olduğu bilgisayara Visual Studio.
Yayımlama ayarlarını içeri aktarma Visual Studio dağıtma
Visual Studio 'da ASP.NET projesinin açık olduğu bilgisayarda Çözüm Gezgini ' de 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 tıklayın veya Yeni profil oluşturun.
Bir profili içeri aktarma seçeneğini belirleyin.
Yayımla Iletişim kutusunda profili içeri aktar' a tıklayın.
Yayımla hedefi seç Iletişim kutusunda profili iç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ı Içeri aktar iletişim kutusunda, öğesine gidin ve önceki bölümde oluşturduğunuz profili 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 Düzenle ' ye tıklayın. Ayarları değiştirin ve yeni ayarları test etmek için Doğrula ' ya tıklayın. Ana bilgisayar adı bulunamazsa sunucu ve hedef URL alanlarında ana bilgisayar adı yerine IP adresini deneyin.
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 Ayarlar ' a tıklayın. Ayarları değiştirin ve yeni ayarları test etmek için Doğrula ' ya tıklayın. Ana bilgisayar adı bulunamazsa sunucu ve hedef URL alanlarında ana bilgisayar adı yerine IP adresini deneyin.

Not
Azure VM'sini yeniden başlattıktan sonra IP adresi değişebilir.
Uygulama başarıyla dağıtıldıktan sonra otomatik olarak başlatılır. Uygulama bir uygulamanın çalışma Visual Studio doğru şekilde çalıştığını doğrulamak için IIS'de uygulamayı başlatabilirsiniz. Daha ASP.NET Core, DefaultAppPool için Uygulama havuzu alanı'nın Yönetilen Kod Yok olarak ayarlanmış olduğundan da emin olun.
Hata Ayarlar iletişim kutusunda, Sonraki'ne tıklayarak hata ayıklamayı etkinleştirin, bir Hata ayıklama yapılandırması seçin ve ardından Dosya Yayımlama seçeneklerinin altında Hedefte ek dosyaları kaldır'ı seçin.
Önemli
Yayın yapılandırmasını seçerseniz, yayımlarkenweb.configdosyasında hata ayıklamayı devre dışı yapılandırmasını devre dışı yapılandırmasınız.
Kaydet'e tıklayın ve uygulamayı yeniden yayımlar.
(İsteğe bağlı) Yerel bir klasöre yayımlaarak dağıtma
Uygulamayı PowerShell veya RoboCopy kullanarak IIS'ye kopyalamak veya dosyaları el ile kopyalamak için bu seçeneği kullanarak uygulamanızı dağıtabilirsiniz.
Windows Server ASP.NET Core web sitesini yapılandırma
Yayımlama ayarlarını içeri aktarıyorsanız bu bölümü atlayabilirsiniz.
Internet Information Services (IIS) Yöneticisi'ni açın ve Siteler'e gidin.
Varsayılan Web Sitesi düğümüne sağ tıklayın ve Uygulama Ekle'yi seçin.
Diğer Ad alanını MyASPApp, Uygulama havuzu alanını Ise Yönetilen Kod Yok olarak ayarlayın. Fiziksel yolu C:\Publish olarak ayarlayın (burada daha sonra ASP.NET Core dağıtacaksınız).
Site IIS Yöneticisi'nde seçiliyken İzinleri Düzenle'yi seçin ve IUSR, IIS_IUSRS veya Uygulama Havuzu için yapılandırılmış kullanıcının Okuma ve Yürütme haklarına sahip yetkili bir kullanıcı olduğundan & olun.
Erişimi olan bu kullanıcılardan birini görmüyorsanız IUSR'yi Okuma ve Yürütme haklarına sahip bir kullanıcı & izleyin.
(İsteğe bağlı) Visual Studio'den yerel bir klasöre yayımlar ve uygulamayı Visual Studio
Web Dağıtımı'yi kullanamıyorsanız, uygulamayı dosya sistemini veya diğer araçları kullanarak yayımlamanız ve dağıtmanız gerekir. Dosya sistemini kullanarak bir paket oluşturarak başlayabilir ve ardından paketi el ile dağıtabilirsiniz veya PowerShell, Robocopy veya XCopy gibi diğer araçları kullanabilirsiniz. Bu bölümde, bir paket kullanıyorsanız paketi el ile kopyalayıp Web Dağıtımı.
Uygulamanın Çözüm Gezgini proje düğümüne sağ tıklayın ve Yayımla'yı seçin (Web Forms 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 yeni bir klasör oluşturun.
Yayımlama profilini kaydetmek için Son'a tıklayın.
Bir Web Forms için Yayımla iletişim kutusunda Özel'i seçin, bir profil adı girin ve Tamam'ı seçin.Açılan listeden Profil oluştur'a tıklayın ( Varsayılan değer Yayımla'dır).
Hata ayıklama yapılandırmasına geçiş.
Profili düzenlemek için Düzenle'yi seçin ve sonra da Ayarlar. Bir Hata ayıklama yapılandırması seçin ve ardından Dosya Yayımlama seçeneklerinin altında Hedefte ek dosyaları kaldır'ı seçin.
Yeni Ayarlar iletişim kutusunda, Sonraki'ne tıklayarak hata ayıklamayı etkinleştirin, 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ımlarkenweb.configdosyasında hata ayıklamayı devre dışı bırakın.
Yayımla’ya tıklayın.

Uygulama, projenin hata ayıklama yapılandırmasını yerel klasöre yayımlar. İlerleme durumu Çıkış penceresinde gösterilir.
Visual Studio ASP.NET proje dizinini ASP.NET Sunucusu bilgisayarına (bu örnekte C:\Publish) yapılandırılan Windows yerel dizine kopyalayın. Bu öğreticide el ile kopyalamanız gerekir, ancak PowerShell, Xcopy veya Robocopy gibi diğer araçları kullanabilirsiniz.
Dikkat
Kodda değişiklik yapmak veya yeniden oluşturmak için bu adımı yeniden yayımlamalı ve tekrarlaabilirsiniz. Uzak makineye kopyalanmış yürütülebilir dosya, yerel kaynağınız ve sembolleriniz ile tam olarak eşleşmeli. Bunu yapmasanız, işlemde hata ayıklamayı Visual Studio bir uyarı
cannot find or open the PDB filealırsınız.Windows Server'da, uygulamayı tarayıcınızda açarak uygulamayı doğru çalıştırabilirsiniz.
Uygulama düzgün çalışmıyorsa, sunucunuza yüklenmiş ASP.NET sürümü ile Visual Studio makineniz arasında bir eşleşmezlik olabilir veya IIS veya Web sitesi yapılandırmanız ile ilgili bir sorun olabilir. Önceki adımları yeniden kontrol edin.
Uzak araçları Windows Server'a indirme ve yükleme
Uzak araçların, uygulama sürümle eşleşen sürümünü Visual Studio.
Visual Studio makine 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ü indirip yükleyin.
- Visual Studio sürümünüz için en son uzak araçları indirin. en son uzak araçlar sürümü önceki Visual Studio sürümlerle uyumludur, ancak önceki uzak araçlar sürümleri daha sonra Visual Studio sürümleriyle uyumlu değildir. (örneğin, Visual Studio 2017 kullanıyorsanız, Visual Studio 2017 için uzak araçların en son güncelleştirmesini indirin. bu senaryoda Visual Studio 2019 için uzak araçları indirmeyin.)
- Yüklediğiniz makineyle aynı mimariye sahip uzak araçları indirin. Örneğin, 64-bit işletim sistemi çalıştıran uzak bir bilgisayarda 32 bitlik bir uygulamada hata ayıklamak istiyorsanız, 64 bit uzak araçları ' nı yükleyebilirsiniz.
| 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 sistemi (x86, x64 veya ARM64) ile eşleşen sürümü indirin. Windows sunucuda, uzak araçları indirme konusunda yardım için bkz. dosya indirme engelini kaldırma . |
| Visual Studio 2019 | Uzak araçlar | tüm Visual Studio 2019 sürümleriyle uyumludur. Cihazınızın işletim sistemi (x86, x64 veya ARM64) ile eşleşen sürümü indirin. Windows sunucuda, uzak araçları indirme konusunda yardım için bkz. dosya indirme engelini kaldırma . |
| Visual Studio 2017 | Uzak araçlar | tüm Visual Studio 2017 sürümleriyle uyumludur. Cihazınızın işletim sistemi (x86, x64 veya ARM64) ile eşleşen sürümü indirin. Windows sunucuda, uzak araçları indirme konusunda yardım için bkz. dosya indirme engelini kaldırma . |
| Visual Studio 2015 | Uzak araçlar | Visual Studio 2015 için uzak araçlar My.VisualStudio.com adresinden edinilebilir. istenirse, ücretsiz Visual Studio Dev Essentials programına katılarak veya Visual Studio abonelik kimliğinizle oturum açın. Windows sunucuda, uzak araçları indirme konusunda yardım için bkz. dosya indirme engelini kaldırma . |
| Visual Studio 2013 | Uzak araçlar | Visual Studio 2013 belgelerine 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 sistemi (x86, x64 veya ARM64) ile eşleşen sürümü indirin. Windows sunucuda, uzak araçları indirme konusunda yardım için bkz. dosya indirme engelini kaldırma . uzak araçların en son sürümü için Visual Studio 2022 belgesiniaçın. |
| Visual Studio 2017 | Uzak araçlar | tüm Visual Studio 2017 sürümleriyle uyumludur. Cihazınızın işletim sistemi (x86, x64 veya ARM64) ile eşleşen sürümü indirin. Windows sunucuda, uzak araçları indirme konusunda yardım için bkz. dosya indirme engelini kaldırma . |
| Visual Studio 2015 | Uzak araçlar | Visual Studio 2015 için uzak araçlar My.VisualStudio.com adresinden edinilebilir. istenirse, ücretsiz Visual Studio Dev Essentials programına katılarak veya Visual Studio abonelik kimliğinizle oturum açın. Windows sunucuda, uzak araçları indirme konusunda yardım için bkz. dosya indirme engelini kaldırma . |
| Visual Studio 2013 | Uzak araçlar | Visual Studio 2013 belgelerine indirme sayfası |
| Visual Studio 2012 | Uzak araçlar | Visual Studio 2012 belgelerinde indirme sayfası |
| Sürüm | Bağlantı | Notlar |
|---|---|---|
| Visual Studio 2017 | Uzak araçlar | tüm Visual Studio 2017 sürümleriyle uyumludur. Cihazınızın işletim sistemi (x86, x64 veya ARM64) ile eşleşen sürümü indirin. Windows sunucuda, uzak araçları indirme konusunda yardım için bkz. dosya indirme engelini kaldırma . uzak araçların en son sürümü için Visual Studio 2019 belgesiniaçın. |
| Visual Studio 2015 | Uzak araçlar | Visual Studio 2015 için uzak araçlar My.VisualStudio.com adresinden edinilebilir. istenirse, ücretsiz Visual Studio Dev Essentials programına katılarak veya Visual Studio abonelik kimliğinizle oturum açın. Windows sunucuda, uzak araçları indirme konusunda yardım için bkz. dosya indirme engelini kaldırma . |
| Visual Studio 2013 | Uzak araçlar | Visual Studio 2013 belgelerine indirme sayfası |
| Visual Studio 2012 | Uzak araçlar | Visual Studio 2012 belgelerinde indirme sayfası |
Uzak araçları yüklemek yerine msvsmon.exe uzak bilgisayara kopyalayarak uzaktan hata ayıklayıcıyı çalıştırabilirsiniz. Ancak, uzaktan 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ıyı bir hizmet olarak çalıştırmak istiyorsanız, yapılandırma için sihirbazı kullanmanız gerekebilir. Daha fazla bilgi için, bkz. (Isteğe bağlı) uzaktan hata ayıklayıcıyı bir hizmet olarak yapılandırma.
Not
- ARM cihazlarında Windows 10 uygulamalarda hata ayıklamak için, uzak araçların en son sürümüyle kullanılabilen ARM64 kullanın.
- Windows RT cihazlarda Windows 10 uygulamalarda hata ayıklamak için, yalnızca Visual Studio 2015 uzak araç indirme sürümünde bulunan ARM 'yi kullanın.
Windows Server'da uzaktan hata ayıklayıcıyı ayarlama
Uzak bilgisayarda, Başlat menüsünden Uzaktan Hata Ayıklayıcı'sını bulun ve başlatın.
Uzak bilgisayarda yönetici izinlerine sahip değilseniz, Uzaktan Hata Ayıklayıcı uygulamasına sağ tıklayın ve Yönetici olarak çalıştır'ı seçin. Aksi takdirde normal şekilde başlat.
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.
Uzaktan hata ayıklayıcıyı ilk kez başlatmanız (veya yapılandırmadan önce), Uzaktan Hata Ayıklama Yapılandırması iletişim kutusu görüntülenir.

Windows Server 2008 R2'de yalnızca Windows Web Hizmetleri API'si yüklüyse Yükle düğmesini seçin.
Uzak araçları kullanmak istediğiniz en az bir ağ türünü seçin. Bilgisayarlar bir etki alanı üzerinden bağlı ise, ilk öğeyi seçmeniz gerekir. Bilgisayarlar bir çalışma grubu veya ev grubu üzerinden bağlıysa, uygun şekilde ikinci veya üçüncü öğeyi seçin.
Güvenlik duvarını yapılandırmak ve uzaktan hata ayıklayıcıyı başlatmak için Uzaktan hata ayıklamayı yapılandır'ı seçin.
Yapılandırma tamamlandığında, Uzaktan Hata Ayıklayıcı penceresi görüntülenir.


Uzak hata ayıklayıcı artık bağlantı bekliyor. Sunucu adı ve bağlantı noktası numarasını kullanarak sunucu içinde uzak bağlantı yapılandırmasını Visual Studio.
Uzaktan hata ayıklayıcıyı durdurmak için Dosya Çıkış'ı > seçin. Başlat menüsünden veya komut satırına bakarak yeniden başlatabilirsiniz:
<Remote debugger installation directory>\msvsmon.exe
Not
Ek kullanıcılar için izin eklemeniz, uzaktan hata ayıklayıcı için kimlik doğrulama modunu veya bağlantı noktası numarasını değiştirmenizi gerekirse, bkz. Uzaktan hata ayıklayıcıyı yapılandırma.
Uygulamanın ASP.NET bilgisayardan Visual Studio ekleme
Bu Visual Studio hata ayıklamaya çalıştığın çözümü açın ( bu makaledeki adımları takip ediyorsanız MyASPApp).
Bu Visual Studio İşleme Ekle (Ctrl + Alt + P) > Hata Ayıkla'ya tıklayın.
İpucu
2017 Visual Studio ve sonraki sürümlerde > Hata Ayıkla ve İşleme Yeniden Ekle... (Shift+Alt+P) kullanarak daha önce bağlı olduğunuz işleme yeniden iliştirebilirsiniz.
Niteleyici alanını olarak ayarlayın ve <remote computer name> Enter tuşuna basın.
Gerekli Visual Studio bilgisayar adına eklendiğinden emin olun. Bu bağlantı noktası şu biçimde görünür: <remote computer name> :p ort
2022'de <remote computer name> :4026'Visual Studio gerekir
<remote computer name> 2019'Visual Studio:4024'ü görüyoruz
2017 Visual Studio de <remote computer name> :4022 ifadesini görüyor gerekir
Bağlantı noktası gereklidir. Bağlantı noktası numarasını görmüyorsanız el ile ekleyin.
Yenile'ye tıklayın. Kullanılabilir İşlemler penceresinde bazı işlemlerin görüntü olduğunu görüyoruz.
Herhangi bir işlem görmüyorsanız, uzak bilgisayar adı yerine IP adresini kullanmayı deneyin (bağlantı noktası gereklidir).
ipconfigIPv4 adresini almak için komut satırı içinde kullanabilirsiniz.Bul düğmesini kullanmak için sunucuda UDP bağlantı noktası 3702'yi açmanız gerekir.
Tüm kullanıcıların işlemlerini göster'i seçin.
Uygulamanızı hızla bulmak için işlem adının ilk harfini yazın.
IIS'de işlem içinde barındırma modelini kullanıyorsanız, doğru işlem w3wp.exe seçin. .NET Core 3'te başlayarak bu varsayılan değerdir.
Aksi takdirde, dotnet.exe seçin. (Bu işlem dışında barındırma modelidir.)
Bir veya birden çok işlem w3wp.exe dotnet.exe Kullanıcı Adı sütununu kontrol edin. Bazı senaryolarda, Kullanıcı Adı sütunu uygulama havuzu adınızı gösterir, örneğin IIS APPPOOL\DefaultAppPool. Uygulama Havuzu'nun benzersiz olmadığını görüyorsanız, hata ayıklamak istediğiniz uygulama örneği için yeni bir adlandırılmış Uygulama Havuzu oluşturun ve bunu Kullanıcı Adı sütununda kolayca bulabilirsiniz.


Ekle'ye tıklayın.
Uzak bilgisayarın web sitesini açın. Bir tarayıcıda, web'e <remote computer name> http://.
Web sayfasında ASP.NET gerekir.
Çalışan ASP.NET sayfasında Hakkında sayfasına tıklayın.
Kesme noktası, Visual Studio.
IIS dağıtımı sorunlarını giderme
- Ana bilgisayar adını kullanarak ana bilgisayara bağlanamıyorsanız bunun yerine IP adresini deneyin.
- Uzak sunucuda gerekli bağlantı noktalarının açık olduğundan emin olun.
- Daha ASP.NET Core için DefaultAppPool için Uygulama havuzu alanı'nın Yönetilen Kod Yok olarak ayarlanmış olduğundan emin olun.
- Uygulamanıza kullanılan ASP.NET sürümünün, sunucuda yüklü olan sürümle aynı olduğunu doğrulayın. Uygulamanız için, Özellikler sayfasında sürümü görüntüleyebilirsiniz ve ayarlayın. Uygulamayı farklı bir sürüme ayarlamak için bu sürümün yüklü olması gerekir.
- Uygulama açılmaya çalışsa ama bir sertifika uyarısı görüyorsanız siteye güvenmeyi seçin. Uyarıyı zaten kapattıysanız projenize *.pubxml dosyası olan yayımlama profilini düzenleyebilir ve aşağıdaki öğeyi eklersiniz (yalnızca test için):
<AllowUntrustedCertificate>true</AllowUntrustedCertificate> - Uygulama, uygulamanın Visual Studio doğru dağıtıldığından emin olmak için IIS'de başlatabilirsiniz.
- Durum bilgileri için Visual Studio penceresini ve hata iletilerinizi kontrol edin.
Windows Server'da gerekli bağlantı noktalarını açma
Çoğu kurulumda gerekli bağlantı noktaları, ASP.NET ve uzaktan hata ayıklayıcının yüklenmesiyle açılır. Ancak, dağıtım sorunlarını gidermeye devam ediyorsanız ve uygulama bir güvenlik duvarının arkasında barındırıldıysa, doğru bağlantı noktalarının açık olduğunu doğrulamanız gerekebilir.
Bir Azure VM'de, Ağ güvenlik grubu aracılığıyla bağlantı noktalarını açabilirsiniz.
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. Uzaktan 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ı).
- 4022 - Visual Studio 2017'den 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ı, hata ayıklayıcısında uzak hata ayıklayıcıya iliştirme sırasında Bul Visual Studio.
Ayrıca, bu bağlantı noktaları yüklemesi tarafından ASP.NET gerekir:
- 8172 - (İsteğe bağlı) Uygulamayı Web Dağıtımı dağıtmak için Visual Studio