Configurer le pare-feu Windows pour le débogage distantConfigure Windows Firewall for remote debugging

Sur un réseau protégé par le pare-feu Windows, le pare-feu doit être configuré pour autoriser le débogage distant.On a network protected by Windows Firewall, the firewall must be configured to permit remote debugging. 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.Visual Studio and the remote debugging tools try to open the correct firewall ports during installation or startup, but you may also need to open ports or allow apps manually.

Cette rubrique explique comment configurer le pare-feu Windows pour activer le débogage à distance sur Windows 10, 8/8.1 et 7. et les ordinateurs Windows Server 2012 R2, 2012 et 2008 R2.This topic describes how to configure the Windows firewall to enable remote debugging on Windows 10, 8/8.1, and 7; and Windows Server 2012 R2, 2012, and 2008 R2 computers. Il n’est pas nécessaire que Visual Studio et l’ordinateur distant exécutent le même système d’exploitation.The Visual Studio and remote computer don't have to be running the same operating system. Par exemple, l’ordinateur Visual Studio peut exécuter Windows 10 et l’ordinateur distant peut exécuter Windows Server 2012 R2.For example, the Visual Studio computer can run Windows 10, and the remote computer can run Windows Server 2012 R2.

Notes

Les instructions de configuration du pare-feu Windows diffèrent légèrement en fonction des systèmes d’exploitation et des versions antérieures de Windows.The instructions for configuring the Windows firewall differ slightly on different operating systems, and for older versions of Windows. Les paramètres Windows 8/8.1, Windows 10 et Windows Server 2012 utilisent le mot application, tandis que Windows 7 et windows Server 2008 utilisent le programme Word.Windows 8/8.1, Windows 10, and Windows Server 2012 settings use the word app, while Windows 7 and Windows Server 2008 use the word program.

Configurer des ports pour le débogage distantConfigure ports for remote debugging

Visual Studio et le débogueur distant essaient d’ouvrir les ports corrects pendant l’installation ou le démarrage.Visual Studio and the remote debugger try to open the correct ports during installation or startup. Toutefois, dans certains scénarios, tels qu’un pare-feu tiers, vous devrez peut-être ouvrir les ports manuellement.However, in some scenarios, such as a third-party firewall, you may need to open ports manually.

Pour ouvrir un port :To open a port:

  1. Dans le menu Démarrer de Windows, recherchez et ouvrez pare-feu Windows avec fonctions avancées de sécurité.In Windows Start menu, search for and open Windows Firewall with Advanced Security. Dans Windows 10, il s’agit du pare-feu Windows Defender avec fonctions avancées de sécurité.In Windows 10, this is Windows Defender Firewall with Advanced Security.

  2. Pour un nouveau port entrant, sélectionnez règles de trafic entrant, puis sélectionnez nouvelle règle.For a new incoming port, select Inbound Rules and then select New Rule. Pour une règle sortante, sélectionnez règles de trafic sortant à la place.For an outgoing rule, select Outbound Rules instead.

  3. Dans l' Assistant Nouvelle règle de trafic entrant, sélectionnez port, puis cliquez sur suivant.In the New Inbound Rule Wizard, select Port, and then select Next.

  4. Sélectionnez TCP ou UDP, selon le numéro de port des tables suivantes.Select either TCP or UDP, depending on the port number from the following tables.

  5. Sous ports locaux spécifiques, entrez un numéro de port parmi les tables suivantes, puis sélectionnez suivant.Under Specific local ports, enter a port number from the following tables, and select Next.

  6. Sélectionnez autoriser la connexion, puis cliquez sur suivant.Select Allow the Connection, and then select Next.

  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.Select one or more network types to enable, including the network type for the remote connection, and then select Next.

  8. Ajoutez un nom pour la règle (par exemple, msvsmon, IIS ou Web Deploy), puis sélectionnez Terminer.Add a name for the rule (for example, msvsmon, IIS, or Web Deploy), and then select Finish.

    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 .The new rule should appear and be selected in the Inbound Rules or Outbound Rules list.

Ports sur l’ordinateur distant qui permettent le débogage distantPorts on the remote computer that enable remote debugging

Pour le débogage distant, les ports suivants doivent être ouverts sur l’ordinateur distant :For remote debugging, the following ports must be open on the remote computer:

PortsPorts Entrant/sortantIncoming/Outgoing ProtocoleProtocol DescriptionDescription
40224022 EntrantIncoming TCPTCP Pour VS 2017.For VS 2017. Le numéro de port est incrémenté de 2 pour chaque version de Visual Studio.The port number increments by 2 for each Visual Studio version. Pour plus d’informations, consultez affectations de port du débogueur distant Visual Studio.For more information, see Visual Studio remote debugger port assignments.
40234023 EntrantIncoming TCPTCP Pour VS 2017.For VS 2017. Le numéro de port est incrémenté de 2 pour chaque version de Visual Studio.The port number increments by 2 for each Visual Studio version. Ce port est utilisé uniquement pour déboguer à distance un processus 32 bits à partir d’une version 64 bits du débogueur distant.This port is only used to remote debug a 32-bit process from a 64-bit version of the remote debugger. Pour plus d’informations, consultez affectations de port du débogueur distant Visual Studio.For more information, see Visual Studio remote debugger port assignments.
37023702 SortantOutgoing UDPUDP Facultatif Requis pour la détection du débogueur distant.(Optional) Required for remote debugger discovery.
PortsPorts Entrant/sortantIncoming/Outgoing ProtocoleProtocol DescriptionDescription
40244024 EntrantIncoming TCPTCP Pour VS 2019.For VS 2019. Le numéro de port est incrémenté de 2 pour chaque version de Visual Studio.The port number increments by 2 for each Visual Studio version. Pour plus d’informations, consultez affectations de port du débogueur distant Visual Studio.For more information, see Visual Studio remote debugger port assignments.
40254025 EntrantIncoming TCPTCP Pour VS 2019.For VS 2019. Le numéro de port est incrémenté de 2 pour chaque version de Visual Studio.The port number increments by 2 for each Visual Studio version. Ce port est utilisé uniquement pour déboguer à distance un processus 32 bits à partir d’une version 64 bits du débogueur distant.This port is only used to remote debug a 32-bit process from a 64-bit version of the remote debugger. Pour plus d’informations, consultez affectations de port du débogueur distant Visual Studio.For more information, see Visual Studio remote debugger port assignments.
37023702 SortantOutgoing UDPUDP Facultatif Requis pour la détection du débogueur distant.(Optional) Required for remote debugger discovery.

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.If you select Use Managed Compatibility Mode under Tools > Options > Debugging, open these additional remote debugger ports. Le mode de compatibilité managé du débogueur active une version héritée de Visual Studio 2010 du débogueur.Debugger Managed Compatibility Mode enables a legacy, Visual Studio 2010 version of the debugger.

PortsPorts Entrant/sortantIncoming/Outgoing ProtocoleProtocol DescriptionDescription
135, 139, 445135, 139, 445 SortantOutgoing TCPTCP Obligatoire.Required.
137, 138137, 138 SortantOutgoing UDPUDP Obligatoire.Required.

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.If your domain policy requires network communication to be performed through IPSec, you must open additional ports on both the Visual Studio and remote computers. Pour déboguer sur un serveur Web IIS distant, ouvrez le port 80 sur l’ordinateur distant.To debug on a remote IIS web server, open port 80 on the remote computer.

PortsPorts Entrant/sortantIncoming/Outgoing ProtocoleProtocol DescriptionDescription
500, 4500500, 4500 SortantOutgoing UDPUDP Requis si votre stratégie de domaine nécessite que la communication réseau soit effectuée via IPSec.Required if your domain policy requires network communication to be performed through IPSec.
8080 SortantOutgoing TCPTCP Requis pour le débogage du serveur web.Required for web server debugging.

Pour autoriser des applications spécifiques par le biais du pare-feu Windows, consultez configurer le débogage à distance via le pare-feu Windows.To allow specific apps through the Windows firewall, see Configure remote debugging through Windows Firewall.

Configurer le débogage à distance via le pare-feu WindowsConfigure remote debugging through Windows firewall

Vous pouvez installer les outils de débogage distant sur l’ordinateur distant ou les exécuter à partir d’un dossier partagé.You can install the remote debugging tools on the remote computer, or run them from a shared folder. Dans les deux cas, le pare-feu de l’ordinateur distant doit être configuré correctement.In either case, the remote computer firewall must be configured correctly.

Sur un ordinateur distant, les outils de débogage distant se trouvent dans :On a remote computer, the remote debugging tools are in:

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

Autoriser et configurer le débogueur distant par le biais du pare-feu WindowsAllow and configure the remote debugger through Windows Firewall

  1. Dans le menu Démarrer de Windows, recherchez et ouvrez le pare-feu Windows ou le pare-feu Windows Defender.In Windows Start menu, search for and open Windows Firewall, or Windows Defender Firewall.

  2. Sélectionnez autoriser une application via le pare-feu Windows.Select Allow an app through Windows Firewall.

  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.If Remote Debugger or Visual Studio Remote Debugger doesn't appear under Allowed apps and features, select Change settings, and then select Allow another app.

  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.If the remote debugger app still isn't listed in the Add an app dialog, select Browse, and navigate to *<Visual Studio installation directory>\Common7\IDE\Remote Debugger\<x86*, x64, or Appx>, depending on the appropriate architecture for your app. Sélectionnez msvsmon.exe, puis Ajouter.Select msvsmon.exe, and then select Add.

  5. Dans la liste des applications , sélectionnez le débogueur distant que vous venez d’ajouter.In the Apps list, select the Remote Debugger that you just added. 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.Select Network types, and then select one or more network types, including the network type for the remote connection.

  6. Sélectionnez Ajouter, puis OK.Select Add, and then select OK.

Résoudre les problèmes liés à la connexion de débogage distantTroubleshoot the remote debugging connection

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.If you can't attach to your app with the remote debugger, make sure the remote debugging firewall ports, protocols, network types, and app settings are all correct.

  • Dans le menu Démarrer de Windows, recherchez et ouvrez le pare-feu Windows, puis sélectionnez autoriser une application via le pare-feu Windows.In the Windows Start menu, search for and open Windows Firewall, and select Allow an app through Windows Firewall. 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.Make sure Remote Debugger or Visual Studio Remote Debugger appears in the Allowed apps and features list with a selected check box, and the correct network types are selected. Si ce n’est pas le cas, Ajoutez les applications et les paramètres appropriés.If not, add the correct apps and settings.

  • Dans le menu Démarrer de Windows, recherchez et ouvrez pare-feu Windows avec fonctions avancées de sécurité.In the Windows Start menu, search for and open Windows Firewall with Advanced Security. 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.Make sure Remote Debugger or Visual Studio Remote Debugger appears under Inbound Rules (and optionally, Outbound Rules) with a green checkmark icon, and that all settings are correct.

    • 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.To view or change the rule settings, right-click the Remote Debugger app in the list and select Properties. 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.Use the Properties tabs to enable or disable the rule, or change port numbers, protocols, or network types.
    • Si l’application du débogueur distant n’apparaît pas dans la liste des règles, Ajoutez et configurez les ports appropriés.If the remote debugger app doesn't appear in the rules list, add and configure the correct ports.

Voir aussiSee also