Konfigurieren der Windows-Firewall für das Remotedebugging

In einem Netzwerk, das durch die Windows-Firewall geschützt ist, muss die Firewall so konfiguriert sein, dass das Remotedebugging zugelassen wird. Visual Studio und die Remotedebuggingtools versuchen, die richtigen Firewallports während der Installation oder beim Start zu öffnen. Möglicherweise müssen Sie aber auch Ports öffnen oder Apps manuell zulassen.

In diesem Thema wird beschrieben, wie Sie die Windows-Firewall so konfigurieren, dass Remotedebugging unter Windows 10, 8/8.1 und 7 aktiviert wird; und Windows Server 2012 R2-, 2012- und 2008 R2-Computer. Visual Studio und Remotecomputer müssen nicht dasselbe Betriebssystem ausführen. Beispielsweise kann der Visual Studio-Computer Windows 11 ausführen, und der Remotecomputer kann Windows Server 2012 R2 ausführen.

Konfigurieren von Ports für das Remotedebugging

Visual Studio und der Remotedebugger versuchen, die richtigen Ports während der Installation oder beim Start zu öffnen. In einigen Szenarien, z. B. einer Firewall eines Drittanbieters, müssen Sie ports möglicherweise manuell öffnen.

So öffnen Sie einen Port:

1. Suchen Sie im Windows-Menü Start nach Windows-Firewall mit erweiterter Sicherheit, und öffnen Sie diesen Eintrag. Ab Windows 10 ist dies Windows Defender Firewall mit erweiterter Sicherheit.

2. Wählen Sie für einen neuen eingehenden Port Eingehende Regeln und danach Neue Regelaus. Wählen Sie für eine Ausgangsregel stattdessen Ausgangsregeln aus.

3. Wählen Sie im Assistenten für neue eingehende Regel zuerst Port und dann Weiter aus.

4. Wählen Sie abhängig von der Portnummer aus den folgenden Tabellen entweder TCP- oder UDP-aus.

5. Geben Sie unter Spezifische lokale Portseine Portnummer aus den folgenden Tabellen ein, und wählen Sie Nextaus.

6. Klicken Sie auf Verbindung zulassen und dann auf Weiter.

7. Wählen Sie einen oder mehrere Netzwerktypen aus, die aktiviert werden sollen, einschließlich des Netzwerktyps für die Remoteverbindung, und wählen Sie dann Nextaus.

8. Fügen Sie einen Namen für die Regel hinzu (z. B. msvsmon, IIS oder Web Deploy), und klicken Sie dann auf Fertig.

   Daraufhin sollte die neue Regel in der Liste Eingangsregeln bzw. Ausgangsregeln angezeigt werden und ausgewählt sein.

So öffnen Sie einen Port mit PowerShell:

Für die Windows-Firewall können Sie PowerShell-Befehle wie New-NetFirewallRuleverwenden.

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

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

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

Ports auf dem Remotecomputer, die das Remotedebugging aktivieren

Für das Remotedebugging müssen die folgenden Ports auf dem Remotecomputer geöffnet sein:

Ports für IPsec und IIS

Wenn Ihre Domänenrichtlinie die Netzwerkkommunikation über Internetprotokollsicherheit (Internet Protocol Security, IPsec) erfordert, müssen Sie zusätzliche Ports sowohl auf den Visual Studio- als auch auf den Remote-Computern öffnen. Zum Debuggen auf einem IIS-Webserver (Remote Internet Information Services) öffnen Sie Port 80 auf dem Remotecomputer.

Informationen zum Zulassen bestimmter Apps über die Windows-Firewall finden Sie unter Konfigurieren des Remotedebuggings über die Windows-Firewall.

Zulassen des Remotedebuggers über die Windows-Firewall

Wenn Sie den Remotedebugger konfigurieren, sollte die Konfigurationssoftware die richtigen Ports auf dem Remotecomputer öffnen. In einigen Szenarien müssen Sie den Remotedebugger jedoch möglicherweise manuell über die Firewall zulassen.

So lassen Sie den Remotedebugger über die Windows-Firewall zu:

1. Suchen und öffnen Sie im Windows-Startmenü die Windows-Firewalloder die Windows Defender Firewall.

2. Wählen Sie Apps über die Windows-Firewall kommunizieren lassen aus.

3. Wenn Remotedebugger oder Visual Studio-Remotedebugger nicht unter "Zugelassene Apps und Features" angezeigt werden, wählen Sie "Andere App zulassen" aus, oder wählen Sie "Einstellungen ändern" und dann "Andere App zulassen" aus.

4. Wenn die Remotedebugger-App immer noch nicht im Dialogfeld "App- hinzufügen" aufgeführt ist, wählen Sie Durchsuchenaus, und navigieren Sie zu <Visual Studio-Installationsverzeichnis>\Common7\IDE\Remote debugger\<x86, x64-oder Appx->, je nach der geeigneten Architektur für Ihre App. Wählen Sie msvsmon.exeaus, und wählen Sie dann "Öffnen" aus.

5. Wählen Sie in der Liste Apps den Remotedebugger aus, den Sie soeben hinzugefügt haben. Wählen Sie Netzwerktypenaus, und wählen Sie dann einen oder mehrere Netzwerktypen aus, einschließlich des Netzwerktyps für die Remoteverbindung.

6. Wählen Sie Addaus, und wählen Sie dann OKaus.

Problembehandlung im Zusammenhang mit der Remotedebugverbindung

Wenn Sie ihre App nicht mit dem Remotedebugger anfügen können, stellen Sie sicher, dass die Firewallports, Protokolle, Netzwerktypen und App-Einstellungen für das Remotedebugging korrekt sind.

• Suchen Sie im Windows-Menü Start nach Windows-Firewall, öffnen Sie diese Option, und wählen Sie Apps über die Windows-Firewall kommunizieren lassen aus. Stellen Sie sicher, dass Remotedebugger oder Visual Studio Remote Debugger in der Liste Zugelassene Apps und Features mit einem aktivierten Kontrollkästchen angezeigt wird und die richtigen Netzwerktypen ausgewählt sind. Andernfalls müssen Sie die richtigen Apps und Einstellungen hinzufügen.

• Suchen Sie im Windows-Menü Start nach Windows-Firewall mit erweiterter Sicherheit, und öffnen Sie diesen Eintrag. Stellen Sie sicher, dass Remotedebugger oder Visual Studio-Remote-Debugger unter Eingehende Regeln (und optional, Ausgehende Regeln) mit einem grünen Häkchensymbol angezeigt wird und dass alle Einstellungen richtig konfiguriert sind.

  • Um die Regeleinstellungen anzuzeigen oder zu ändern, klicken Sie mit der rechten Maustaste auf die Remotedebugger--App in der Liste, und wählen Sie Eigenschaftenaus. Verwenden Sie die Eigenschaften Registerkarten, um die Regel zu aktivieren oder zu deaktivieren oder Portnummern, Protokolle oder Netzwerktypen zu ändern.
  • Wenn die Remotedebugger-App nicht in der Regelliste angezeigt wird, fügen Sie die richtigen Ports hinzu und konfigurieren Sie sie.

Verwandte Inhalte

• Remotedebuggen
• Zuweisungen der Remotedebugger-Ports in Visual Studio