Configurare Windows Firewall per il debug remoto

In una rete protetta da Windows Firewall, il firewall deve essere configurato per consentire il debug remoto. Visual Studio e gli strumenti di debug remoto tentano di aprire le porte del firewall corrette durante l'installazione o l'avvio, ma potrebbe anche essere necessario aprire porte o consentire le app manualmente.

Questo argomento descrive come configurare Windows Firewall per abilitare il debug remoto in Windows 10, 8/8.1 e 7; e i computer Windows Server 2012 R2, 2012 e 2008 R2. Non è necessario che Visual Studio e il computer remoto eseguano lo stesso sistema operativo. Ad esempio, il computer Visual Studio può eseguire Windows 11 e il computer remoto può eseguire Windows Server 2012 R2.

Nota

Le istruzioni per la configurazione di Windows Firewall differiscono leggermente in sistemi operativi diversi e per le versioni precedenti di Windows. Le impostazioni di Windows 8/8.1, Windows 10 e versioni successive e Windows Server 2012 usano la parola app, mentre Windows 7 e Windows Server 2008 usano la parola programma.

Configurare le porte per il debug remoto

Visual Studio e il debugger remoto tentano di aprire le porte corrette durante l'installazione o l'avvio. In alcuni scenari, ad esempio un firewall di terze parti, potrebbe essere necessario aprire manualmente le porte.

Per aprire una porta:

1. In Windows menu Start, cercare e aprire Windows Firewall con sicurezza avanzata. A partire da Windows 10, questo è Windows Defender Firewall con sicurezza avanzata.

2. Per una nuova porta in ingresso, selezionare Regole in ingresso e quindi selezionare Nuova regola. Per una regola in uscita, selezionare Regole in uscita.

3. Nel Creazione Guidata Nuova Regola in Ingresso, Selezionare Portae quindi selezionare Avanti.

4. Selezionare TCP o UDP, a seconda del numero di porta delle tabelle seguenti.

5. In Porte locali specifiche, immettere un numero di porta dalle tabelle seguenti e selezionare Avanti.

6. Selezionare Consenti connessionee quindi selezionare Avanti.

7. Selezionare uno o più tipi di rete da abilitare, incluso il tipo di rete per la connessione remota, quindi selezionare Avanti.

8. Aggiungi un nome per la regola (ad esempio msvsmon, IISo Web Deploy), quindi seleziona Fine.

   La nuova regola deve apparire e essere selezionata nell'elenco regole in ingresso o regole in uscita.

Per aprire una porta tramite PowerShell:

Per Windows Firewall, è possibile usare comandi di PowerShell, ad esempio New-NetFirewallRule.

Nell'esempio seguente viene aperta la porta 4026 per il debugger remoto nel computer remoto. La porta e il percorso da usare potrebbero essere diversi.

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

Porte nel computer remoto che abilitano il debug remoto

Per il debug remoto, è necessario aprire le porte seguenti nel computer remoto:

porte	Entrata/Uscita	Protocollo	Descrizione
4026	In arrivo	TCP	Per Visual Studio 2022. Per ulteriori informazioni, vedere le assegnazioni delle porte del debugger remoto di Visual Studio.
4025	In arrivo	TCP	Per Visual Studio 2022 e Servizio app di Microsoft Azure. Questa porta viene usata solo per eseguire il debug remoto di un processo a 32 bit da una versione a 64 bit del debugger remoto. Per altre informazioni, vedere assegnazioni di porte del debugger remoto di Visual Studio.
4024	In arrivo	TCP	Per Servizio App di Microsoft Azure. Per ulteriori informazioni, vedere le assegnazioni delle porte del debugger remoto di Visual Studio.
3702	In uscita	UDP	(Facoltativo) Obbligatorio per l'individuazione remota del debugger.

Se i criteri di dominio richiedono l'esecuzione delle comunicazioni di rete tramite Internet Protocol Security (IPsec), è necessario aprire porte aggiuntive sia in Visual Studio che nei computer remoti. Per eseguire il debug in un server Web INTERNET Information Services (IIS) remoto, aprire la porta 80 nel computer remoto.

porte	In ingresso/In uscita	protocollo	Descrizione
500, 4500	In uscita	UDP	Obbligatorio se i criteri di dominio richiedono l'esecuzione delle comunicazioni di rete tramite IPsec.
80	In uscita	TCP	Obbligatorio per il debug del server Web.

Per consentire app specifiche tramite Windows Firewall, vedere Configurare il debug remoto tramite Windows Firewall.

Consentire il debugger remoto tramite Windows Firewall

Quando si configurare il debugger remoto, il software di configurazione deve aprire le porte corrette. Tuttavia, in alcuni scenari potrebbe essere necessario consentire manualmente il debugger remoto tramite il firewall.

Per consentire il debugger remoto tramite Windows Firewall:

1. In Windows menu Start cercare e aprire Windows Firewallo Windows Defender Firewall.

2. Selezionare Consenti un'app tramite Windows Firewall.

3. Se Remote Debugger o Visual Studio Remote Debugger non viene visualizzato in App e funzionalità consentite, cliccare su Modifica impostazioni, e quindi su Consenti un'altra applicazione.

4. Se l'app per il debug remoto non è ancora elencata nella finestra di dialogo Aggiungi app, selezionare Sfogliae navigare <alla directory di installazione di Visual Studio>\Common7\IDE\Remote Debugger\<x86, x64o Appx>, a seconda dell'architettura appropriata per l'app. Selezionare msvsmon.exee quindi selezionare Aggiungi.

5. Nell'elenco app, selezionare il debugger remoto appena aggiunto. Selezionare Tipi di retee quindi selezionare uno o più tipi di rete, incluso il tipo di rete per la connessione remota.

6. Selezionare Aggiungie quindi selezionare OK.

Risolvere i problemi relativi alla connessione di debug remoto

Se non è possibile connettersi all'app con il debugger remoto, assicurarsi che le porte del firewall, i protocolli, i tipi di rete e le impostazioni dell'app siano tutti corretti.

• Nel menu Start di Windows cercare e aprire Windows Firewalle selezionare Consenti un'app tramite Windows Firewall. Assicurati che Remote Debugger o Visual Studio Remote Debugger appaiano nell'elenco App e funzionalità consentite con una casella di controllo selezionata e che siano selezionati i tipi di rete corretti. In caso contrario, aggiungi le app e le impostazioni corrette.

• Nel menu Start di Windows cercare e aprire Windows Firewall con Sicurezza Avanzata. Assicurarsi che Debugger Remoto o Debugger Remoto di Visual Studio venga visualizzato sotto Regole in Ingresso (e, facoltativamente, Regole in Uscita) con un'icona di segno di spunta verde, e che tutte le impostazioni siano configurate correttamente.

  • Per visualizzare o modificare le impostazioni della regola, fare clic con il pulsante destro del mouse sull'app debugger remoto nell'elenco e selezionare Proprietà. Utilizzare le schede Proprietà per abilitare o disabilitare la regola oppure modificare numeri di porta, protocolli o tipi di rete.
  • Se l'app debugger remoto non viene visualizzata nell'elenco delle regole, aggiungere le porte corrette e configurarle.

Contenuto correlato

• debug remoto
• assegnazioni di porte del debugger remoto di Visual Studio