Uzaktan Hata Ayıklama

Farklı bir bilgisayarda Visual Studio bir uygulamanın hata ayıklaması. Bunu yapmak için uzak hata ayıklayıcısını Visual Studio kullanın.

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

Senaryo Bağlantı
Azure App Service Azure'ASP.NET uzaktan hata ayıklama veya Visual Studio Enterprise için Snapshot Debugger
Azure VM Azure’da ASP.NET hatalarını uzaktan ayıklama
Azure Service Fabric Azure Service Fabric uygulamasında hata ayıklama
ASP.NET Uzaktan hata ayıklama ASP.NET Core veya Uzaktan Hata Ayıklama ASP.NET
C# veya Visual Basic Uzaktan C# veya Visual Basic projesi hatası ayıklama
C++ C++ projesinin hatalarını uzaktan ayıklama
Universal Windows Apps (UWP) Uzak makinede UWP uygulamaları çalıştırma veya Yüklü uygulama paketinde hata ayıklama

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

Uzak araçları indirme ve yükleme

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.

Gereksinim -leri

Desteklenen İşletim Sistemleri

Uzak bilgisayarın aşağıdaki işletim sistemlerinden birini çalıştırıyor olması gerekir:

  • 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

Not

Windows Phone hata ayıklama için USB bağlantısı gerektirir (uzak araçlar gerektirmez).

Desteklenen donanım yapılandırması

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

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

  • 1 GB kullanılabilir sabit disk alanı

  • 5400-RPM sabit sürücü

  • 1024 x 768 veya daha yüksek görüntü çözünürlüğünde çalışan DirectX 9 uyumlu ekran kartı

Ağ yapılandırması

uzak bilgisayar ve Visual Studio bilgisayar bir ağ, çalışma grubu veya ev grubu üzerinden bağlanmalıdır ya da başka bir şekilde doğrudan Ethernet kablosu üzerinden bağlanmış olmalıdır. Proxy üzerinden bağlı iki bilgisayar arasında hata ayıklama desteklenmez. Yüksek gecikme veya düşük bant genişliğine sahip bir bağlantı (örneğin, Internet veya ülkeler arasında Internet üzerinden) için hata ayıklama önerilmez ve başarısız olabilir veya aşırı derecede yavaş olabilir.

(İsteğe bağlı) Uzaktan hata ayıklayıcıyı bir dosya paylaşımından çalıştırmak için

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

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

    Program Files\Microsoft Visual Studio\2022\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exe

    Program Files\Microsoft Visual Studio\2022\Enterprise\Common7\IDE\Remote Debugger\x86\msvsmon.exe

    Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exe

    Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\Remote Debugger\x86\msvsmon.exe

    Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\Remote Debugger\x86\msvsmon.exe

    Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exe

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

  3. Uzak bilgisayarda, paylaşılan msvsmon.exe'i çalıştırın. Kurulum yönergelerini izleyin.

İpucu

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

Uzaktan hata ayıklayıcıyı ayarlama

  1. 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.

  2. 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.

    Uzaktan Hata Ayıklayıcı yapılandırması

  3. Windows Server 2008 R2'de yalnızca Windows Web Hizmetleri API'si yüklüyse Yükle düğmesini seçin.

  4. 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.

  5. 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.

  6. Yapılandırma tamamlandığında, Uzaktan Hata Ayıklayıcı penceresi görüntülenir.

    Uzaktan Hata Ayıklayıcısı penceresi

    Uzaktan Hata Ayıklayıcısı penceresi

    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

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

Uzaktan 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 uzaktan hata ayıklayıcısına bağlanması için izinler eklemeniz gerekirse Araçlar ve İzinler'> seçin. İzinleri vermek veya reddetmek için yönetici ayrıcalıklarınızın olması gerekir.

    Önemli

    Uzak hata ayıklayıcıyı, Visual Studio bilgisayarda kullanmakta olan 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ını eklemeniz gerekir.

    Alternatif olarak, uzak hata ayıklayıcısını komut satırına /allow <username> 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 gerekirse: Araçlar ve Seçenekler'i > seçin.

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

    Uyarı

    Uzak araçları Kimlik Doğrulaması Yok modunda çalıştırmayı seçebilirsiniz, fakat 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 olduğundan emin değilken seçin.

(İ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ıştırmak için uzak hata ayıklayıcıyı bir hizmet olarak çalıştırmanız gerekir.

Uzak hata ayıklayıcıyı bir hizmet olarak yapılandırmak için aşağıdaki adımları izleyin.

  1. Uzaktan Hata Ayıklayıcı Yapılandırma Sihirbazı'nı (rdbgwiz.exe). (Bu, Uzaktan Hata Ayıklayıcı'dan ayrı bir uygulamadır.) Yalnızca uzak araçları yüklemenizde kullanılabilir. Bu, Visual Studio.

  2. Yapılandırma sihirbazını çalıştırmaya başlama. İlk sayfa geldiğinde, Sonraki'ne tıklayın.

  3. Visual Studio 2015 Uzaktan Hata Ayıklayıcısını hizmet olarak çalıştır onay kutusunu işaretleyin.

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

    Bu hesaba hizmet olarak oturum açma kullanıcı hakkı eklemeniz (Başlangıç sayfasında veya penceresinde Yerel Güvenlik İlkesini Bul (secpol.msc) veya bir komut isteminde secpol yazmanız gerekir. Pencere görüntülendiğinde Kullanıcı Hakları Ataması'ne çift tıklayın ve ardından sağ bölmede Hizmet olarak oturum aç'ı bulun. Çift tıklayın. Kullanıcı hesabını Özellikler penceresine ekleyin ve Tamam'a tıklayın. İleri’ye tıklayın.

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

  6. Hizmet başlatlanıyorsa, Yapılandırma Sihirbazı'nı başarıyla tamamladınız Visual Studio Uzaktan Hata Ayıklayıcı görüntülenir. Hizmet başlatılamayacaksa, Yapılandırma Sihirbazı'nda Visual Studio Uzaktan Hata Ayıklayıcı görüntülenir. Sayfa ayrıca hizmeti başlatmaya yardımcı olmak için takip edecek bazı ipuçları da sağlar.

  7. Finish (Son) düğmesine tıklayın.

    Bu noktada uzak hata ayıklayıcı bir hizmet olarak çalışıyor. Denetim Masası > Services'e gidip Visual Studio 2015 Uzaktan Hata Ayıklayıcı'ya bakarak bunu doğruabilirsiniz.

    uzaktan hata ayıklayıcı hizmetini Denetim Masası > başlatabilirsiniz.

Uzak sembollerle hata ayıklamayı ayarlama

Kodun hata ayıklaması, kod bilgisayarda oluşturulan sembollerle Visual Studio gerekir. Yerel semboller kullanıyorken uzak hata ayıklayıcının performansı çok daha iyidir. Uzak semboller kullanmak zorundaysanız, uzaktan hata ayıklama izleyiciye uzak makinede sembollere bakmasını söylemeniz gerekir.

Güncelleştirme 2 Visual Studio 2013 den başlayarak, yönetilen kod için uzak sembolleri kullanmak üzere 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ı 'ne bakın (uzaktan hata ayıklayıcı penceresinde F1 tuşuna basın veya Kullanım için Yardım'> tıklayın). 2012 ve 2013'te .NET Uzak Sembol Yükleme Visual Studio daha fazla bilgi bulabilirsiniz

Ayrıca bkz.