configurer Windows pare-feu pour le débogage distant

sur un réseau protégé par Windows pare-feu, le pare-feu doit être configuré pour autoriser le débogage distant. Visual Studio et les outils de débogage distant essaient d’ouvrir les ports de pare-feu corrects pendant l’installation ou le démarrage, mais vous devrez peut-être également ouvrir les ports ou autoriser les applications manuellement.

cette rubrique explique comment configurer le pare-feu Windows pour activer le débogage à distance sur les ordinateurs Windows 10, 8/8.1 et 7 et Windows Server 2012 r2, 2012 et 2008 r2. le Visual Studio et l’ordinateur distant n’ont pas besoin d’exécuter le même système d’exploitation. par exemple, le Visual Studio ordinateur peut exécuter Windows 11 et l’ordinateur distant peut exécuter Windows Server 2012 R2.

Notes

les instructions de configuration du pare-feu Windows diffèrent légèrement sur les différents systèmes d’exploitation et pour les versions antérieures de Windows. Windows 8/8,1, Windows 10 et versions plus récentes, et les paramètres de Windows Server 2012 utilisent le mot application, tandis que Windows 7 et Windows Server 2008 utilisent le programme word.

Configurer des ports pour le débogage distant

Visual Studio et le débogueur distant essaient d’ouvrir les ports corrects pendant l’installation ou le démarrage. Toutefois, dans certains scénarios, tels qu’un pare-feu tiers, vous devrez peut-être ouvrir les ports manuellement.

Pour ouvrir un port :

  1. dans Windows menu démarrer , recherchez et ouvrez Windows pare-feu avec fonctions avancées de sécurité. à partir de Windows 10, il s’agit d' Windows Defender pare-feu avec fonctions avancées de sécurité.

  2. Pour un nouveau port entrant, sélectionnez règles de trafic entrant, puis sélectionnez nouvelle règle. Pour une règle sortante, sélectionnez règles de trafic sortant à la place.

  3. Dans l' Assistant Nouvelle règle de trafic entrant, sélectionnez port, puis cliquez sur suivant.

  4. Sélectionnez TCP ou UDP, selon le numéro de port des tables suivantes.

  5. Sous ports locaux spécifiques, entrez un numéro de port parmi les tables suivantes, puis sélectionnez suivant.

  6. Sélectionnez autoriser la connexion, puis cliquez sur suivant.

  7. Sélectionnez un ou plusieurs types de réseau à activer, y compris le type de réseau pour la connexion à distance, puis sélectionnez suivant.

  8. Ajoutez un nom pour la règle (par exemple, msvsmon, IIS ou Web Deploy), puis sélectionnez Terminer.

    La nouvelle règle doit apparaître et être sélectionnée dans la liste règles de trafic entrant ou règles de trafic sortant .

Pour ouvrir un port à l’aide de PowerShell :

pour Windows pare-feu, vous pouvez utiliser des commandes PowerShell telles que New-NetFirewallRule.

L’exemple suivant ouvre le port 4026 pour le débogueur distant sur l’ordinateur distant. Le chemin d’accès que vous devez utiliser peut être différent.

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

L’exemple suivant ouvre le port 4024 pour le débogueur distant sur l’ordinateur distant. Le chemin d’accès que vous devez utiliser peut être différent.

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 sur l’ordinateur distant qui permettent le débogage distant

Pour le débogage distant, les ports suivants doivent être ouverts sur l’ordinateur distant :

Ports Entrant/sortant Protocole Description
4026 Entrant TCP Pour VS 2022. pour plus d’informations, consultez Visual Studio les affectations de port du débogueur distant.
4025 Entrant TCP Pour VS 2022. Ce port est utilisé uniquement pour déboguer à distance un processus 32 bits à partir d’une version 64 bits du débogueur distant. pour plus d’informations, consultez Visual Studio les affectations de port du débogueur distant.
3702 Sortant UDP Facultatif Requis pour la détection du débogueur distant.
Ports Entrant/sortant Protocole Description
4024 Entrant TCP Pour VS 2019. le numéro de port est incrémenté de 2 pour chaque version de Visual Studio. pour plus d’informations, consultez Visual Studio les affectations de port du débogueur distant.
4025 Entrant TCP Pour VS 2019. Ce port est utilisé uniquement pour déboguer à distance un processus 32 bits à partir d’une version 64 bits du débogueur distant. pour plus d’informations, consultez Visual Studio les affectations de port du débogueur distant.
3702 Sortant UDP Facultatif Requis pour la détection du débogueur distant.
Ports Entrant/sortant Protocole Description
4022 Entrant TCP Pour VS 2017. le numéro de port est incrémenté de 2 pour chaque version de Visual Studio. pour plus d’informations, consultez Visual Studio les affectations de port du débogueur distant.
4023 Entrant TCP Pour VS 2017. le numéro de port est incrémenté de 2 pour chaque version de Visual Studio. Ce port est utilisé uniquement pour déboguer à distance un processus 32 bits à partir d’une version 64 bits du débogueur distant. pour plus d’informations, consultez Visual Studio les affectations de port du débogueur distant.
3702 Sortant UDP Facultatif Requis pour la détection du débogueur distant.

Si vous sélectionnez utiliser le mode de compatibilité managé dans Outils > options > de débogage, ouvrez ces ports supplémentaires du débogueur distant. le Mode de compatibilité managé du débogueur active une version héritée Visual Studio 2010 du débogueur.

Ports Entrant/sortant Protocole Description
135, 139, 445 Sortant TCP Obligatoire.
137, 138 Sortant UDP Obligatoire.

si votre stratégie de domaine nécessite que la communication réseau soit effectuée via IPSec, vous devez ouvrir des ports supplémentaires sur les ordinateurs Visual Studio et distants. Pour déboguer sur un serveur Web IIS distant, ouvrez le port 80 sur l’ordinateur distant.

Ports Entrant/sortant Protocole Description
500, 4500 Sortant UDP Requis si votre stratégie de domaine nécessite que la communication réseau soit effectuée via IPSec.
80 Sortant TCP Requis pour le débogage du serveur web.

pour autoriser des applications spécifiques par le biais du pare-feu Windows, consultez configurer le débogage à distance via Windows pare-feu.

configurer le débogage à distance via un pare-feu Windows

Vous pouvez installer les outils de débogage distant sur l’ordinateur distant ou les exécuter à partir d’un dossier partagé. Dans les deux cas, le pare-feu de l’ordinateur distant doit être configuré correctement.

Sur un ordinateur distant, les outils de débogage distant se trouvent dans :

<Visual Studio installation directory>\Débogueur distant IDE \ Common7 \\<x86, x64, or Appx>

autoriser et configurer le débogueur distant par le biais du pare-feu Windows

  1. dans Windows menu démarrer , recherchez et ouvrez Windows pare-feu ou Windows Defender pare-feu.

  2. sélectionnez autoriser une application via le pare-feu Windows.

  3. si le débogueur distant ou le Débogueur distant Visual Studio ne s’affiche pas sous applications et fonctionnalités autorisées, sélectionnez modifier les paramètres, puis sélectionnez autoriser une autre application.

  4. Si l’application du débogueur distant n’est toujours pas listée dans la boîte de dialogue Ajouter une application , sélectionnez Parcourir, puis accédez à * <Visual Studio installation directory> \ Common7 \ IDE \ Remote Debugger \ <x86*, x64, or Appx> , en fonction de l’architecture appropriée pour votre application. Sélectionnez msvsmon.exe, puis Ajouter.

  5. Dans la liste des applications , sélectionnez le débogueur distant que vous venez d’ajouter. Sélectionnez types de réseau, puis sélectionnez un ou plusieurs types de réseau, y compris le type de réseau pour la connexion à distance.

  6. Sélectionnez Ajouter, puis OK.

Résoudre les problèmes liés à la connexion de débogage distant

Si vous ne pouvez pas attacher votre application avec le débogueur distant, assurez-vous que les ports de pare-feu de débogage distant, les protocoles, les types de réseau et les paramètres d’application sont tous corrects.

  • dans le menu démarrer de Windows, recherchez et ouvrez Windows pare-feu, puis sélectionnez autoriser une application via Windows pare-feu. vérifiez que débogueur distant ou Débogueur distant Visual Studio apparaît dans la liste applications et fonctionnalités autorisées avec une case à cocher activée et que les types de réseau corrects sont sélectionnés. Si ce n’est pas le cas, Ajoutez les applications et les paramètres appropriés.

  • dans le menu démarrer de Windows, recherchez et ouvrez Windows pare-feu avec fonctions avancées de sécurité. assurez-vous que débogueur distant ou Débogueur distant Visual Studio apparaît sous règles de trafic entrant (et éventuellement les règles de trafic sortant) avec une icône de coche verte et que tous les paramètres sont corrects.

    • Pour afficher ou modifier les paramètres de règle, cliquez avec le bouton droit sur l’application du débogueur distant dans la liste et sélectionnez Propriétés. Utilisez les onglets Propriétés pour activer ou désactiver la règle, ou modifier les numéros de port, les protocoles ou les types de réseau.
    • Si l’application du débogueur distant n’apparaît pas dans la liste des règles, Ajoutez et configurez les ports appropriés.

Voir aussi