Débogage à distance

Vous pouvez déboguer une application Visual Studio qui a été déployée sur un autre ordinateur. Pour ce faire, utilisez le débogueur distant Visual Studio.

Pour obtenir des instructions détaillées sur le débogage à distance, consultez ces rubriques.

Scénario	Lien
C# ou Visual Basic	Déboguer à distance un projet C# ou Visual Basic
C++	Déboguer à distance un projet C++
Azure App Service	Déboguer à distance ASP.NET Core sur Azure ou, pour Visual Studio Enterprise, le Débogueur de capture instantanée
ASP.NET	Déboguer à distance ASP.NET Core ou Déboguer à distance ASP.NET
Machine virtuelle Azure	Débogage à distance d'ASP.NET sur une machine virtuelle Azure
Linux	Déboguer .NET Core sur Linux à l’aide de SSH en se connectant à un processus
Docker	Attacher à un processus en cours d’exécution dans un conteneur Docker
Applications Windows universelles (UWP)	exécuter des applications UWP sur un ordinateur distant ou déboguer un package d’application installé

Si vous souhaitez simplement télécharger et installer le débogueur distant et n’avez pas besoin d’instructions supplémentaires pour votre scénario, suivez les étapes décrites dans cet article.

Télécharger et installer les outils à distance

Sur l’appareil ou le serveur distant sur lequel vous souhaitez déboguer, plutôt que sur l’ordinateur Visual Studio, téléchargez et installez la version correcte des outils distants à partir des liens figurant dans le tableau suivant.

• Téléchargez la mise à jour la plus récente des outils à distance pour votre version de Visual Studio. Les versions antérieures des outils distants ne sont pas compatibles avec les versions ultérieures de Visual Studio. (Par exemple, si vous utilisez Visual Studio 2019, téléchargez la dernière mise à jour des outils à distance pour Visual Studio 2019. Dans ce scénario, ne téléchargez pas les outils à distance pour Visual Studio 2022.)
• Téléchargez les outils distants avec la même architecture que la machine sur laquelle vous les installez. Par exemple, si vous souhaitez déboguer des applications x86 sur un ordinateur distant exécutant un système d’exploitation x64, installez les outils à distance x64. Pour déboguer des applications x86, ARM ou x64 sur un système d’exploitation ARM64, installez les outils à distance ARM64.

Version	Lien	Notes
Visual Studio 2022	Outils de télétravail	Compatible avec toutes les versions de Visual Studio 2022. Téléchargez la version correspondant à votre système d’exploitation d’appareil (x86, x64 (AMD64) ou ARM64). Sur les versions plus anciennes de Windows Server, consultez Débloquer le téléchargement de fichier pour obtenir de l’aide sur le téléchargement des outils distants.
Visual Studio 2019	Outils à distance	Les outils à distance pour Visual Studio 2019 sont disponibles à partir de My.VisualStudio.com. Si vous y êtes invité, rejoignez le programme gratuit Visual Studio Dev Essentials ou connectez-vous avec votre ID d’abonnement Visual Studio. Téléchargez la version correspondant à votre système d’exploitation d’appareil (x86, x64 (AMD64) ou ARM64). Sur les versions plus anciennes de Windows Server, consultez Débloquer le téléchargement de fichier pour obtenir de l’aide sur le téléchargement des outils distants.
Visual Studio 2017	Outils à distance	Les outils à distance pour Visual Studio 2017 sont disponibles à partir de My.VisualStudio.com. Si vous y êtes invité, rejoignez le programme gratuit Visual Studio Dev Essentials ou connectez-vous avec votre ID d’abonnement Visual Studio. Téléchargez la version correspondant à votre système d’exploitation d’appareil (x86, x64 (AMD64) ou ARM64). Sur Windows Server, consultez Débloquer le téléchargement du fichier pour obtenir de l’aide sur le téléchargement des outils de contrôle à distance.
Visual Studio 2015	outils de travail à distance	Les outils à distance pour Visual Studio 2015 sont disponibles à partir de My.VisualStudio.com. Si vous y êtes invité, rejoignez le programme gratuit Visual Studio Dev Essentials ou connectez-vous avec votre ID d’abonnement Visual Studio. Sur Windows Server, consultez Débloquer le téléchargement du fichier pour obtenir de l’aide sur le téléchargement des outils de contrôle à distance.
Visual Studio 2013	Outils à distance	Page de téléchargement dans la documentation Visual Studio 2013
Visual Studio 2012	Outils à distance	Page de téléchargement dans la documentation de Visual Studio 2012

Vous pouvez exécuter le débogueur distant en copiant msvsmon.exe sur l’ordinateur distant, plutôt que d’installer les outils distants. Toutefois, l’Assistant Configuration du débogueur distant (rdbgwiz.exe) n’est disponible que lorsque vous installez les outils de contrôle à distance. Vous devrez peut-être utiliser l’Assistant pour la configuration si vous souhaitez exécuter le débogueur distant en tant que service. Pour plus d’informations, consultez (Facultatif) Configurer le débogueur distant en tant que service.

Note

• Pour déboguer des applications Windows 10 ou ultérieures sur des appareils ARM, utilisez ARM64, qui est disponible avec la dernière version des outils à distance.
• Pour déboguer des applications Windows 10 sur des appareils Windows RT, utilisez ARM, qui est disponible uniquement dans le téléchargement des outils à distance Visual Studio 2015.
• Pour déboguer des applications x64 sur un système d’exploitation ARM64, exécutez la msvsmon.exe x64 installée avec les outils à distance ARM64.

Exigences

Systèmes d’exploitation pris en charge

L’ordinateur distant doit exécuter l’un des systèmes d’exploitation suivants :

• Windows 11

• Windows 10 (pas de téléphone)

• Windows 8 ou 8.1 (pas téléphone)

• Windows 7 Service Pack 1

• Windows Server 2016

• Windows Server 2012 ou Windows Server 2012 R2

• Windows Server 2008 Service Pack 2, Windows Server 2008 R2 Service Pack 1

Configurations matérielles prises en charge

• Processeur 1,6 GHz ou plus rapide

• 1 Go de RAM (1,5 Go en cas d’exécution sur une machine virtuelle)

• 1 Go d’espace disque disponible

• Disque dur 5400 RPM

• Carte vidéo compatible directX 9 s’exécutant à 1024 x 768 ou une résolution d’affichage supérieure

Configuration réseau

L’ordinateur distant et l’ordinateur Visual Studio doivent être connectés via un réseau, un groupe de travail ou un groupe résidentiel, ou bien connecté directement via un câble Ethernet. Le débogage entre deux ordinateurs connectés via un proxy n’est pas pris en charge. Le débogage sur une connexion à haute latence ou à faible bande passante, comme l'Internet par modem, ou sur Internet à travers des pays/régions, n'est pas recommandé et peut échouer ou être inacceptablement lent.

(Facultatif) Pour exécuter le débogueur distant à partir d’un partage de fichiers

Vous pouvez trouver le débogueur distant (msvsmon.exe) sur un ordinateur avec Visual Studio Community, Professional ou Enterprise déjà installé. Pour certains scénarios, le moyen le plus simple de configurer le débogage distant consiste à exécuter le débogueur distant (msvsmon.exe) à partir d’un partage de fichiers. Pour connaître les limitations d’utilisation, consultez la page d’aide du débogueur distant (Aide > Utilisation dans le débogueur distant).

1. Recherchez msvsmon.exe dans le répertoire correspondant à votre version de Visual Studio :

   Fichiers de programme\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x64\msvsmon.exe

   Program Files\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x86\msvsmon.exe

2. Partagez le dossier Débogueur distant sur l’ordinateur Visual Studio.

3. Sur l’ordinateur distant, exécutez msvsmon.exe à partir du dossier partagé. Suivez les instructions de configuration .

Conseil

Pour l'installation en ligne de commande et la référence de ligne de commande, consultez la page d’aide de msvsmon.exe en tapant msvsmon.exe /? dans la ligne de commande sur l’ordinateur où Visual Studio est installé (ou allez à Aide > Utilisation dans le débogueur distant).

Configurer le débogueur distant

1. Sur l’ordinateur distant, recherchez et démarrez le Débogueur distant à partir du menu Démarrer.

   Si vous n’avez pas d’autorisations d’administration sur l’ordinateur distant, cliquez avec le bouton droit sur l’application de débogueur distant, puis sélectionnez Exécuter en tant qu’administrateur. Sinon, il suffit de le démarrer normalement.

   Si vous envisagez d’attacher un processus qui s’exécute en tant qu’administrateur ou s’exécute sous un autre compte d’utilisateur (par exemple, IIS), cliquez avec le bouton droit sur l’application débogueur distant et sélectionnez Exécuter en tant qu’administrateur. Pour plus d’informations, consultez Exécuter le débogueur distant en tant qu’administrateur.

2. La première fois que vous démarrez le débogueur distant (ou avant de l'avoir configuré), l’Assistant de configuration de débogage à distance s'affiche.

   Dans la plupart des scénarios, choisissez Suivant jusqu’à ce que vous accédiez à la page Configurer le Pare-feu Windows de l’Assistant.

   

3. Sélectionnez au moins un type de réseau sur lequel vous souhaitez utiliser les outils distants. Si les ordinateurs sont connectés via un domaine, vous devez choisir le premier élément. Si les ordinateurs sont connectés via un groupe de travail ou un groupe résidentiel, choisissez le deuxième ou le troisième élément le cas échéant.

   Ensuite, sélectionnez Terminer pour démarrer le débogueur distant.

4. Une fois la configuration terminée, la fenêtre Débogueur distant s’affiche.

   Capture d’écran

   Le débogueur distant attend maintenant une connexion. Utilisez le nom du serveur et le numéro de port indiqués pour définir la configuration de la connexion à distance dans Visual Studio.

Pour arrêter le débogueur distant, sélectionnezFichier>Quitter. Vous pouvez le redémarrer à partir du menu Démarrer ou à partir de la ligne de commande :

<Remote debugger installation directory>\msvsmon.exe

Configurer le débogueur distant

Vous pouvez modifier certains aspects de la configuration du débogueur distant une fois que vous l’avez démarré pour la première fois.

• Si vous devez ajouter des autorisations pour que d’autres utilisateurs se connectent au débogueur distant, choisissez Outils > Autorisations. Vous devez disposer de privilèges d’administrateur pour accorder ou refuser des autorisations.

  Important

  Vous pouvez exécuter le débogueur distant sous un compte d’utilisateur qui diffère du compte d’utilisateur que vous utilisez sur l’ordinateur Visual Studio, mais vous devez ajouter le compte d’utilisateur différent aux autorisations du débogueur distant.

  Vous pouvez également démarrer le débogueur distant à partir de la ligne de commande avec le paramètre /allow <nom d’utilisateur> : msvsmon /allow <username@computer>.

• Si vous devez modifier le mode d’authentification ou le numéro de port, ou spécifier une valeur de délai d’attente pour les outils distants : choisissez Outils > Options.

  Pour obtenir la liste des numéros de port utilisés par défaut, consultez Affectations de port au débogueur distant.

  Avertissement

  Vous pouvez choisir d’exécuter les outils distants en mode Aucune authentification, mais ce mode est fortement déconseillé. Il n’existe aucune sécurité réseau lorsque vous exécutez ce mode. Choisissez le mode Aucune authentification uniquement si vous êtes sûr que le réseau n’est pas exposé à un trafic malveillant ou hostile.

Configurer Visual Studio pour le débogage à distance

Pour obtenir des instructions détaillées pour vous connecter à l’application à partir de Visual Studio, utilisez les liens liés à votre scénario spécifique au début de cet article.

Certains scénarios nécessitent l'utilisation de la fonction Attacher au processus pour se connecter à une application distante déjà démarrée. Toutefois, pour les applications .NET Core, .NET 5+, .NET Framework et C++, vous pouvez lancer l’application distante à partir de Visual Studio en configurant les propriétés du projet et en démarrant le débogueur. Pour plus d’informations, consultez débogage distant d’un projet C# ou Visual Basic ou débogage distant d’un projet C++.

Vous pouvez également déboguer à distance un exécutable qui ne fait pas partie d’un projet Visual Studio, bien que les fonctionnalités de débogage prises en charge dépendent de la configuration, comme la disponibilité des symboles. Pour plus d’informations, consultez Déboguer une application qui ne fait pas partie d’une solution Visual Studio.

(Facultatif) Configurer le débogueur distant en tant que service

Pour le débogage dans ASP.NET et d’autres environnements serveur, vous devez exécuter le débogueur distant en tant qu’administrateur ou, si vous le souhaitez toujours en cours d’exécution, exécutez le débogueur distant en tant que service.

Si vous souhaitez configurer le débogueur distant en tant que service, procédez comme suit.

1. Recherchez l’Assistant Configuration du débogueur distant (rdbgwiz.exe). (Il s’agit d’une application distincte du débogueur distant.) Il est disponible uniquement lorsque vous installez les outils distants. Elle n’est pas installée avec Visual Studio.

2. Démarrez l’Assistant Configuration. Lorsque la première page s’affiche, cliquez sur suivant.

3. Cochez la case Exécuter le débogueur distant Visual Studio en tant que service.

4. Ajoutez le nom du compte d’utilisateur et du mot de passe.

   Vous devrez peut-être ajouter le droit d’utilisateur Se connecter en tant que service à ce compte. Recherchez Stratégie de sécurité locale (secpol.msc) dans la page ou la fenêtre Démarrer (ou tapez secpol à une invite de commandes). Lorsque la fenêtre s'affiche, double-cliquez sur Attribution des droits utilisateur, puis recherchez Connexion en tant que service dans le volet droit. Double-cliquez dessus. Ajoutez le compte d’utilisateur à la fenêtre propriétés de , puis cliquez sur OK). Cliquez sur suivant.

5. Sélectionnez le type de réseau avec lequel vous souhaitez que les outils distants communiquent. Au moins un type de réseau doit être sélectionné. Si les ordinateurs sont connectés via un domaine, vous devez choisir le premier élément. Si les ordinateurs sont connectés via un groupe de travail ou un groupe résidentiel, vous devez choisir les deuxième ou troisième éléments. Cliquez sur Suivant.

6. Si le service peut être démarré, le message suivant s’affiche : L’assistant Configuration du débogueur distant Microsoft Visual Studio est terminé. Si le service ne peut pas être démarré, vous verrez Échec de l’exécution de l’assistant Configuration du débogueur distant Visual Studio. La page fournit également quelques conseils à suivre pour démarrer le service.

7. Cliquez sur Terminer.

   À ce stade, le débogueur distant s’exécute en tant que service. Vous pouvez vérifier cela en accédant à Panneau de configuration > Services et en recherchant Débogueur distant Visual Studio.

   Vous pouvez arrêter et démarrer le service du débogueur distant à partir de Panneau de configuration > Services.

Configurer le débogage avec des symboles distants

Vous devez être en mesure de déboguer votre code avec les symboles que vous générez sur l’ordinateur Visual Studio. Les performances du débogueur distant sont beaucoup mieux lorsque vous utilisez des symboles locaux. Si vous devez utiliser des symboles distants, vous devez indiquer au moniteur de débogage distant de rechercher des symboles sur l’ordinateur distant.

Vous pouvez utiliser le commutateur de ligne de commande msvsmon suivant pour utiliser des symboles distants pour le code managé : Msvsmon /FallbackLoadRemoteManagedPdbs

Pour plus d’informations, consultez l’aide sur le débogage à distance (appuyez sur F1 dans la fenêtre du débogueur distant, ou cliquez sur Aide > Utilisation).

Contenu connexe

• Premier aperçu du débogueur
• Configurer le Pare-feu Windows pour le débogage distant
• Affectations de port du débogueur distant
• Débogage à distance d'ASP.NET Core sur un ordinateur IIS distant
• Erreurs de Débogage à Distance et Résolution des Problèmes