Windows Güvenlik Duvarı'nı uzaktan hata ayıklama için yapılandırma

Windows Güvenlik Duvarı tarafından korunan bir ağda, güvenlik duvarı uzaktan hata ayıklamaya izin vermek üzere yapılandırılmalıdır. Visual Studio ve uzaktan hata ayıklama araçları yükleme veya başlatma sırasında doğru güvenlik duvarı bağlantı noktalarını açmaya çalışır, ancak bağlantı noktalarını açmanız veya uygulamalara el ile izin vermeniz de gerekebilir.

Bu konuda, Windows 10, 8/8.1 ve 7'de uzaktan hata ayıklamayı etkinleştirmek için Windows Güvenlik Duvarı'nın nasıl yapılandırıldığı açıklanır; ve Windows Server 2012 R2, 2012 ve 2008 R2 bilgisayarları. Visual Studio ve uzak bilgisayarın aynı işletim sistemini çalıştırması gerekmez. Örneğin, Visual Studio bilgisayarı Windows 11'i, uzak bilgisayar ise Windows Server 2012 R2'yi çalıştırabilir.

Not

Windows Güvenlik Duvarı'nı yapılandırma yönergeleri farklı işletim sistemlerinde ve windows'un eski sürümlerinde biraz farklılık gösterir. Windows 8/8.1, Windows 10 ve daha yeni sürümler ve Windows Server 2012 ayarları word uygulamasını kullanırken, Windows 7 ve Windows Server 2008 ise word programını kullanır.

Bağlantı noktalarını uzaktan hata ayıklama için yapılandırma

Visual Studio ve uzak hata ayıklayıcı, yükleme veya başlatma sırasında doğru bağlantı noktalarını açmaya çalışır. Ancak, üçüncü taraf güvenlik duvarı gibi bazı senaryolarda bağlantı noktalarını el ile açmanız gerekebilir.

Bağlantı noktasını açmak için:

  1. Windows Başlat menüsünde Gelişmiş Güvenlik özellikli Windows Güvenlik Duvarı'nı arayın ve açın. Windows 10'dan başlayarak, bu Gelişmiş Güvenlik özellikli Windows Defender Güvenlik Duvarı'dır.

  2. Yeni gelen bağlantı noktası için Gelen Kuralları'na ve ardından Yeni Kural'a tıklayın. Giden kuralı için bunun yerine Giden Kuralları'yı seçin.

  3. Yeni Gelen Kuralı Sihirbazı'nda Bağlantı Noktası'nı ve ardından İleri'yi seçin.

  4. Aşağıdaki tablolardan bağlantı noktası numarasına bağlı olarak TCP veya UDP'yi seçin.

  5. Belirli yerel bağlantı noktaları'nın altında, aşağıdaki tablolardan bir bağlantı noktası numarası girin ve İleri'yi seçin.

  6. Bağlan izin ver'i ve ardından İleri'yi seçin.

  7. Uzak bağlantının ağ türü de dahil olmak üzere etkinleştirmek üzere bir veya daha fazla ağ türü seçin ve ardından İleri'yi seçin.

  8. Kural için bir ad ekleyin (örneğin, msvsmon, IIS veya Web Dağıtımı) ve ardından Son'u seçin.

    Yeni kural görünmelidir ve Gelen Kuralları veya Giden Kuralları listesinde seçilmelidir.

PowerShell kullanarak bir bağlantı noktasını açmak için:

Windows Güvenlik Duvarı için New-NetFirewallRule gibi PowerShell komutlarını kullanabilirsiniz.

Aşağıdaki örnek, uzak bilgisayardaki uzak hata ayıklayıcısı için 4026 numaralı bağlantı noktasını açar. Kullanmanız gereken bağlantı noktası ve yol farklı olabilir.

New-NetFirewallRule -DisplayName "msvsmon" -Direction Inbound -Program "Program Files\Microsoft Visual Studio\2022\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exe" -LocalPort 4026 -Protocol TCP -Authentication Required -Action Allow

Aşağıdaki örnek, uzak bilgisayardaki uzak hata ayıklayıcı için 4024 numaralı bağlantı noktasını açar. Kullanmanız gereken yol farklı olabilir.

New-NetFirewallRule -DisplayName "msvsmon" -Direction Inbound -Program "Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exe" -LocalPort 4024 -Protocol TCP -Authentication Required -Action Allow

Uzak bilgisayardaki uzaktan hata ayıklamayı etkinleştiren bağlantı noktaları

Uzaktan hata ayıklama için uzak bilgisayarda aşağıdaki bağlantı noktalarının açık olması gerekir:

Bağlantı noktaları Gelen/Giden Protokol Açıklama
4026 Gelen TCP Visual Studio 2022 için. Daha fazla bilgi için bkz . Visual Studio uzaktan hata ayıklayıcısı bağlantı noktası atamaları.
4025 Gelen TCP Visual Studio 2022 ve Microsoft Azure Uygulaması Service için. Bu bağlantı noktası yalnızca uzak hata ayıklayıcının 64 bit sürümünden 32 bitlik bir işlemde uzaktan hata ayıklamak için kullanılır. Daha fazla bilgi için bkz . Visual Studio uzaktan hata ayıklayıcısı bağlantı noktası atamaları.
4024 Gelen TCP Microsoft Azure Uygulaması Hizmeti için. Daha fazla bilgi için bkz . Visual Studio uzaktan hata ayıklayıcısı bağlantı noktası atamaları.
3702 Giden UDP (İsteğe bağlı) Uzaktan hata ayıklayıcı bulma için gereklidir.
Bağlantı noktaları Gelen/Giden Protokol Açıklama
4024 Gelen TCP Visual Studio 2019 ve Microsoft Azure Uygulaması Service için. Her Visual Studio sürümü için bağlantı noktası sayısı 2 artar. Daha fazla bilgi için bkz . Visual Studio uzaktan hata ayıklayıcısı bağlantı noktası atamaları.
4025 Gelen TCP Visual Studio 2019 ve Azure Uygulaması Hizmeti için. Bu bağlantı noktası yalnızca uzak hata ayıklayıcının 64 bit sürümünden 32 bitlik bir işlemde uzaktan hata ayıklamak için kullanılır. Daha fazla bilgi için bkz . Visual Studio uzaktan hata ayıklayıcısı bağlantı noktası atamaları.
3702 Giden UDP (İsteğe bağlı) Uzaktan hata ayıklayıcı bulma için gereklidir.

Araçlar>Seçenekler>Hata Ayıklama'nın altında Yönetilen Uyumluluk Modunu Kullan'ı seçerseniz, bu ek uzak hata ayıklayıcı bağlantı noktalarını açın. Hata Ayıklayıcı Yönetilen Uyumluluk Modu, hata ayıklayıcının eski bir Visual Studio 2010 sürümünü etkinleştirir.

Bağlantı noktaları Gelen/Giden Protokol Açıklama
135, 139, 445 Giden TCP Gerekli.
137, 138 Giden UDP Gerekli.

Etki alanı ilkeniz İnternet Protokolü Güvenliği (IPSec) aracılığıyla ağ iletişiminin gerçekleştirilebilmesini gerektiriyorsa, hem Visual Studio hem de uzak bilgisayarlarda ek bağlantı noktaları açmanız gerekir. Uzak IIS web sunucusunda hata ayıklamak için uzak bilgisayarda 80 numaralı bağlantı noktasını açın.

Bağlantı noktaları Gelen/Giden Protokol Açıklama
500, 4500 Giden UDP Etki alanı ilkeniz IPSec üzerinden ağ iletişimini gerektiriyorsa gereklidir.
80 Giden TCP Web sunucusu hata ayıklaması için gereklidir.

Belirli uygulamalara Windows Güvenlik Duvarı üzerinden izin vermek için bkz . Windows Güvenlik Duvarı aracılığıyla uzaktan hata ayıklamayı yapılandırma.

Windows Güvenlik Duvarı aracılığıyla uzaktan hata ayıklayıcıya izin verme

Uzak hata ayıklayıcıyı yapılandırdığınızda, yapılandırma yazılımı doğru bağlantı noktalarını açmalıdır. Ancak bazı senaryolarda uzaktan hata ayıklayıcıya güvenlik duvarı üzerinden el ile izin vermeniz gerekebilir.

Windows Güvenlik Duvarı aracılığıyla uzak hata ayıklayıcıya izin vermek için:

  1. Windows Başlat menüsünde Windows Güvenlik Duvarı'nı veya Windows Defender Güvenlik Duvarı'nı arayın ve açın.

  2. Windows Güvenlik Duvarı üzerinden uygulamaya izin ver'i seçin.

  3. İzin verilen uygulamalar ve özellikler altında Uzaktan Hata Ayıklayıcı veya Visual Studio Uzaktan Hata Ayıklayıcı görünmüyorsa Ayarları değiştir'i ve ardından Başka bir uygulamaya izin ver'i seçin.

  4. Uygulama ekle iletişim kutusunda uzak hata ayıklayıcı uygulaması hala listelenmiyorsa Gözat'ı seçin ve uygulamanız için uygun mimariye <bağlı olarak Visual Studio yükleme dizini>\Common7\IDE\Remote Debugger\<x86, x64 veya Appx'e> gidin. msvsmon.exe'ı ve ardından Ekle'yi seçin.

  5. Uygulamalar listesinde, yeni eklediğiniz Uzak Hata Ayıklayıcı'yı seçin. Ağ türleri'ni seçin ve ardından uzak bağlantının ağ türü de dahil olmak üzere bir veya daha fazla ağ türü seçin.

  6. Ekle'yi ve ardından Tamam'ı seçin.

Uzaktan hata ayıklama bağlantısı sorunlarını giderme

Uzaktan hata ayıklayıcı ile uygulamanıza ekleyemiyorsanız, uzaktan hata ayıklama güvenlik duvarı bağlantı noktalarının, protokollerin, ağ türlerinin ve uygulama ayarlarının doğru olduğundan emin olun.

  • Windows Başlat menüsünde Windows Güvenlik Duvarı'nı arayın ve açın ve Bir uygulamaya Windows Güvenlik Duvarı üzerinden izin ver'i seçin. İzin verilen uygulamalar ve özellikler listesinde Seçili bir onay kutusuyla Uzaktan Hata Ayıklayıcı'nın veya Visual Studio Uzaktan Hata Ayıklayıcı göründüğünden ve doğru ağ türlerinin seçildiğinden emin olun. Aksi takdirde, doğru uygulamaları ve ayarları ekleyin.

  • Windows Başlat menüsünde Gelişmiş Güvenlik özellikli Windows Güvenlik Duvarı'nı arayın ve açın. Uzaktan Hata Ayıklayıcı'nın veya Visual Studio Uzaktan Hata Ayıklayıcı Gelen Kuralları'nın altında (ve isteğe bağlı olarak Giden Kuralları) yeşil onay işareti simgesiyle görüntülendiğinden ve tüm ayarların doğru olduğundan emin olun.

    • Kural ayarlarını görüntülemek veya değiştirmek için listeden Uzak Hata Ayıklayıcı uygulamasına sağ tıklayın ve Özellikler'i seçin. Kuralı etkinleştirmek veya devre dışı bırakmak ya da bağlantı noktası numaralarını, protokolleri veya ağ türlerini değiştirmek için Özellikler sekmelerini kullanın.
    • Uzaktan hata ayıklayıcı uygulaması kurallar listesinde görünmüyorsa, doğru bağlantı noktalarını ekleyin ve yapılandırın.