Uzaktan Hata Ayıklama

Farklı bir bilgisayara dağıtılmış bir Visual Studio uygulamasında hata ayıklayabilirsiniz. Bunu yapmak için Visual Studio uzaktan hata ayıklayıcısını kullanırsınız.

Uzaktan hata ayıklama hakkında ayrıntılı yönergeler için bu konulara bakın.

Senaryo	Bağlantı
C# veya Visual Basic	C# veya Visual Basic projelerini uzaktan hata ayıklama
C++	C++ projesinde uzaktan hata ayıklama
Azure App Service	Azure'da ASP.NET Core uzaktan hata ayıklama veya Visual Studio Enterprise için Snapshot Debugger
ASP.NET	Uzaktan hata ayıklama ASP.NET Core veya uzaktan hata ayıklama ASP.NET
Azure VM	Azure VM üzerinde uzaktan hata ayıklama ASP.NET
Linux	Bir işleme ekleyerek SSH kullanarak Linux'ta .NET Core hata ayıklayın
Docker	Docker kapsayıcısında çalışan bir işleme ekleme
Evrensel Windows Uygulamaları (UWP)	UWP uygulamalarını uzak bir makinede çalıştırma veya yüklü bir uygulama paketinde hata ayıklama

Yalnızca uzaktan hata ayıklayıcıyı indirip yüklemek istiyorsanız ve senaryonuz için ek yönergelere ihtiyacınız yoksa, bu makaledeki adımları izleyin.

Uzak araçları indirme ve yükleme

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	uzaktan kullanılan 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ı indirirken yardım için dosya indirme engelini kaldırma konusunda bilgi almak amacıyla ve'e bakın.
Visual Studio 2019	uzaktan 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 engelini kaldırma bölümüne bakın.
Visual Studio 2017	Uzaktan erişim 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 bakın.
Visual Studio 2015	Uzaktan erişim 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 bakın.
Visual Studio 2013	uzaktan erişim araçları	Visual Studio 2013 belgelerinde indirme sayfası
Visual Studio 2012	uzaktan erişim 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 sisteminde x64 uygulamalarında hata ayıklamak için ARM64 uzak araçlarıyla yüklenen x64 msvsmon.exe'ı çalıştırın.

Gereksinimler

Desteklenen İşletim Sistemleri

Uzak bilgisayar aşağıdaki işletim sistemlerinden birini çalıştırıyor olmalıdır:

• Windows 11

• Windows 10 (telefon değil)

• Windows 8 veya 8.1 (telefon değil)

• Windows 7 Service Pack 1

• Windows Server 2016

• Windows Server 2012 veya Windows Server 2012 R2

• Windows Server 2008 Service Pack 2, Windows Server 2008 R2 Service Pack 1

Desteklenen Donanım Yapılandırmaları

• 1,6 GHz veya daha hızlı işlemci

• 1 GB RAM (sanal makinede çalışıyorsa 1,5 GB)

• 1 GB kullanılabilir sabit disk alanı

• 5400 RPM sabit sürücü

• 1024 x 768 veya üzeri ekran çözünürlüğünde çalışan DirectX 9 özellikli ekran kartı

Ağ yapılandırması

Uzak bilgisayar ve Visual Studio bilgisayarı bir ağ, çalışma grubu veya ev grubu üzerinden veya doğrudan bir Ethernet kablosu üzerinden bağlanmalıdır. 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.

(İsteğe bağlı) Dosya paylaşımından uzak hata ayıklayıcısını çalıştırmak için

Uzak hata ayıklayıcıyı (msvsmon.exe) Visual Studio Community, Professional veya Enterprise'ın zaten yüklü olduğu bir bilgisayarda bulabilirsiniz. Bazı senaryolarda, uzaktan hata ayıklamayı ayarlamanın en kolay yolu, bir dosya paylaşımından uzak hata ayıklayıcıyı (msvsmon.exe) çalıştırmaktır. Kullanım sınırlamaları için, uzak hata ayıklayıcının Yardım sayfasına (Yardım > Uzak hata ayıklayıcıda Kullanım) bakın.

1. Visual Studio sürümünüzle eşleşen dizinde msvsmon.exe bulun:

   Program Dosyaları\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x64\msvsmon.exe

   Program Dosyaları\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x86\msvsmon.exe

2. Visual Studio bilgisayarındaki Uzak Hata Ayıklayıcısı klasörünü paylaşın.

3. Uzak bilgisayarda, paylaşılan klasörden msvsmon.exe çalıştırın. kurulum yönergelerini izleyin.

Bahşiş

Komut satırı yükleme ve komut satırı başvurusu için, Visual Studio'nun yüklü olduğu bilgisayarda komut satırına msvsmon.exe /? yazarak msvsmon.exe yardım sayfasına bakın (veya uzak hata ayıklayıcıda Yardım > Kullanım bölümüne gidin).

Uzak hata ayıklayıcıyı ayarlama

1. Uzak bilgisayarda, Başlat menüsünden Uzaktan Hata Ayıklayıcı bulup başlatın.

   Uzak bilgisayarda yönetici izinleriniz yoksa, Uzaktan Hata Ayıklayıcısı 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.

2. Uzaktan hata ayıklayıcıyı ilk kez başlattığınızda (veya yapılandırmadan önce), Uzaktan Hata Ayıklama Yapılandırması sihirbazı görüntülenir.

   Çoğu senaryoda, Next seçeneğini tıklayın ve sihirbazın Windows Güvenlik Duvarı'nı Yapılandırma sayfasına gelene kadar devam edin.

   

3. 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, Bitiş'ni seçerek uzak hata ayıklayıcısını başlatın.

4. Yapılandırma tamamlandığında Uzaktan 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 Dosya>Çıkışseçeneğini seçin. Başlat menüsünden veya komut satırından yeniden başlatabilirsiniz:

<Remote debugger installation directory>\msvsmon.exe

Uzak hata ayıklayıcıyı yapılandırma

Uzak hata ayıklayıcıyı ilk kez başlattıktan sonra yapılandırmanın bazı yönlerini değiştirebilirsiniz.

• Diğer kullanıcıların uzak hata ayıklayıcıya bağlanması için izin eklemeniz gerekiyorsa, Araçlar > İzinler'ni seçin. İzin vermek veya reddetmek için yönetici ayrıcalıklarına sahip olmanız gerekir.

  Önemli

  Uzaktan hata ayıklayıcısını Visual Studio bilgisayarında kullandığınız kullanıcı hesabından farklı bir kullanıcı hesabı altında çalıştırabilirsiniz, ancak uzak hata ayıklayıcının izinlerine farklı kullanıcı hesabı eklemeniz gerekir.

  Alternatif olarak, uzak hata ayıklayıcıyı komut satırından /allow <kullanıcı adı> parametresiyle başlatabilirsiniz: msvsmon /allow <username@computer>.

• Kimlik doğrulama modunu veya bağlantı noktası numarasını değiştirmeniz veya uzak araçlar için bir zaman aşımı değeri belirtmeniz gerekiyorsa: Araçlar > Seçeneklerseçeneğini belirleyin.

  Varsayılan olarak kullanılan bağlantı noktası numaralarının listesi için bkz. Uzak Hata Ayıklayıcısı Bağlantı Noktası Atamaları.

  Uyarı

  Uzak araçları Kimlik Doğrulaması Yok modunda çalıştırmayı seçebilirsiniz, ancak bu mod kesinlikle önerilmez. Bu modda çalıştırdığınızda ağ güvenliği yoktur. Kimlik Doğrulaması Yok modunu yalnızca ağın kötü amaçlı veya saldırgan trafik riski altında olmadığından eminseniz seçin.

Visual Studio'yu uzaktan hata ayıklama için yapılandırma

Visual Studio'dan uygulamaya bağlanmaya yönelik ayrıntılı yönergeler için bu makalenin başındaki belirli senaryonuzla ilgili bağlantıları kullanın.

Bazı senaryolar, zaten başlatılmış olan uzak bir uygulamaya bağlanmak için Attach to Process özelliğinin kullanılmasını gerektirir. Ancak .NET Core, .NET 5+, .NET Framework ve C++ uygulamaları için proje özelliklerini yapılandırarak ve hata ayıklayıcısını başlatarak uzak uygulamayı Visual Studio'dan başlatabilirsiniz. Daha fazla bilgi için bkz. C# veya Visual Basic projesinde uzaktan hata ayıklama veya C++ projesinde uzaktan hata ayıklama .

Desteklenen hata ayıklama özellikleri simgelerin kullanılabilirliği gibi yapılandırmaya bağlı olsa da, Visual Studio projesinin parçası olmayan bir yürütülebilir dosyada uzaktan hata ayıklama da yapabilirsiniz. Daha fazla bilgi için bkz. Visual Studio çözümünün parçası olmayan bir uygulamada hata ayıklama.

(İsteğe bağlı) Uzak hata ayıklayıcıyı hizmet olarak yapılandırma

ASP.NET ve diğer sunucu ortamlarında hata ayıklama için, uzak hata ayıklayıcıyı Yönetici olarak çalıştırmanız veya her zaman çalışmasını istiyorsanız, uzak hata ayıklayıcıyı hizmet olarak çalıştırmanız gerekir.

Uzak hata ayıklayıcısını bir hizmet olarak yapılandırmak istiyorsanız aşağıdaki adımları izleyin.

1. Uzaktan Hata Ayıklayıcısı Yapılandırma Sihirbazı'nı (rdbgwiz.exe) bulun. (Bu, Uzak Hata Ayıklayıcı'dan ayrı bir uygulamadır.) Yalnızca uzak araçları yüklediğinizde kullanılabilir. Visual Studio ile birlikte yüklenmez.

2. Yapılandırma sihirbazını çalıştırmaya başlayın. İlk sayfa açıldığında, İleridüğmesine tıklayın.

3. Visual Studio Uzaktan Hata Ayıklayıcısı'nı hizmet olarak çalıştır seçeneğinin onay kutusunu işaretleyin.

4. Kullanıcı hesabının adını ve parolasını ekleyin.

   Hizmet olarak oturum açma kullanıcı hakkını bu hesaba eklemeniz gerekebilir. Başlangıç sayfasına veya penceresine gidin ve Yerel Güvenlik İlkesi (secpol.msc) bulun (veya komut isteminde secpol yazın). Pencere görüntülendiğinde, Kullanıcı Hakları Ataması'ne çift tıklayın, ardından sağ bölmede Hizmet olarak oturum açma cümlesini bulun. Çift tıklayın. Kullanıcı hesabını Özellikler penceresine ekleyin ve Tamam) öğesine tıklayın. İleri tıklayın.

5. Uzak araçların iletişim kurmasını istediğiniz ağ türünü seçin. En az bir ağ türü seçilmelidir. 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ü öğeleri seçmeniz gerekir. İleriöğesine tıklayın.

6. Hizmet başlatılabiliyorsa, Visual Studio Uzaktan Hata Ayıklayıcısı Yapılandırma Sihirbazı'nı başarıyla tamamladınızgörürsünüz. Hizmet başlatılamıyorsa, Visual Studio Uzaktan Hata Ayıklayıcısı Yapılandırma Sihirbazıtamamlanamadı ifadesini görürsünüz. Sayfa ayrıca hizmetin başlatılmasını sağlamak için izlemeniz gereken bazı ipuçları da sunar.

7. Son'ne tıklayın.

   Bu noktada, uzak hata ayıklayıcı hizmet olarak çalışıyor. Denetim Masası > Services gidip Visual Studio Uzaktan Hata Ayıklayıcıarayarak bunu doğrulayabilirsiniz.

   Denetim Masası Hizmetler > üzerinde uzaktan hata ayıklayıcı hizmetini durdurabilir ve başlatabilirsiniz.

Uzak simgelerle hata ayıklamayı ayarlama

Visual Studio bilgisayarında oluşturduğunuz sembollerle kodunuzun hatalarını ayıklayabilmeniz gerekir. Yerel simgeleri kullandığınızda uzak hata ayıklayıcının performansı çok daha iyidir. Uzak simgeler kullanmanız gerekiyorsa, uzak hata ayıklama izleyicisine uzak makinede sembolleri aramasını söylemeniz gerekir.

Yönetilen kod için uzak simgeleri kullanmak için aşağıdaki msvsmon komut satırı anahtarını kullanabilirsiniz: Msvsmon /FallbackLoadRemoteManagedPdbs

Daha fazla bilgi için lütfen uzaktan hata ayıklama yardımına bakın (uzak hata ayıklayıcı penceresinde F1 basın veya Yardım > Kullanımöğesine tıklayın).

İlgili içerik

• Hata ayıklayıcıya ilk bakış
• Windows Güvenlik Duvarı'nı Uzaktan Hata Ayıklama için Yapılandırma
• Uzak Hata Ayıklayıcı Port Atamaları
• Uzak IIS Bilgisayar 'da Uzaktan Hata Ayıklama ASP.NET Çekirdeğini
• Uzaktan Hata Ayıklama ve Sorun Giderme