Remote Debugging

S’applique à :yesVisual Studio noVisual Studio pour Mac noVisual Studio Code

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
Azure App Service Débogage à distance ASP.NET Core sur Azure ou, pour Visual Studio Enterprise, le débogueur d’instantané
Azure VM Débogage distant ASP.NET sur une machine virtuelle Azure
Azure Service Fabric Déboguer une application Azure Service Fabric
ASP.NET Débogage à distance ASP.NET Core ou ASP.NET de débogage à distance
C# ou Visual Basic Déboguer à distance un projet C# ou Visual Basic
C++ Déboguer à distance un projet C++
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 de contrôle à distance

Sur l’appareil ou le serveur distant sur lequel vous souhaitez déboguer, au lieu de l’ordinateur Visual Studio, téléchargez et installez la version correcte des outils distants à partir des liens du tableau suivant.

  • Téléchargez les outils distants les plus récents pour votre version de Visual Studio. La dernière version des outils distants est compatible avec les versions antérieures de Visual Studio, mais les versions antérieures des outils distants ne sont pas compatibles avec les versions ultérieures Visual Studio. (Par exemple, si vous utilisez Visual Studio 2017, téléchargez la dernière mise à jour des outils à distance pour Visual Studio 2017. Dans ce scénario, ne téléchargez pas les outils à distance pour Visual Studio 2019.)
  • 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 une application 32 bits sur un ordinateur distant exécutant un système d’exploitation 64 bits, installez les outils distants 64 bits.
Version Lien Remarques
Visual Studio 2022 outils de contrôle à distance. Compatible avec toutes les versions Visual Studio 2022. Téléchargez la version correspondant à votre système d’exploitation d’appareil (x86, x64 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 distants.
Visual Studio 2019 outils de contrôle à distance. Compatible avec toutes les versions Visual Studio 2019. Téléchargez la version correspondant à votre système d’exploitation d’appareil (x86, x64 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 distants.
Visual Studio 2017 outils de contrôle à distance. Compatible avec toutes les versions Visual Studio 2017. Téléchargez la version correspondant à votre système d’exploitation d’appareil (x86, x64 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 distants.
Visual Studio 2015 outils de contrôle à distance. Les outils à distance pour Visual Studio 2015 sont disponibles à partir de My.VisualStudio.com. Si vous y êtes invité, rejoignez le programme de Visual Studio Dev Essentials gratuit 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 distants.
Visual Studio 2013 outils de contrôle à distance. Page de téléchargement dans Visual Studio 2013 documentation
Visual Studio 2012 outils de contrôle à distance. Page de téléchargement dans la documentation Visual Studio 2012
Version Lien Remarques
Visual Studio 2019 outils de contrôle à distance. Compatible avec toutes les versions Visual Studio 2019. Téléchargez la version correspondant à votre système d’exploitation d’appareil (x86, x64 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 distants. Pour la version la plus récente des outils à distance, ouvrez la documentation Visual Studio 2022.
Visual Studio 2017 outils de contrôle à distance. Compatible avec toutes les versions Visual Studio 2017. Téléchargez la version correspondant à votre système d’exploitation d’appareil (x86, x64 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 distants.
Visual Studio 2015 outils de contrôle à distance. Les outils à distance pour Visual Studio 2015 sont disponibles à partir de My.VisualStudio.com. Si vous y êtes invité, rejoignez le programme de Visual Studio Dev Essentials gratuit 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 distants.
Visual Studio 2013 outils de contrôle à distance. Page de téléchargement dans Visual Studio 2013 documentation
Visual Studio 2012 outils de contrôle à distance. Page de téléchargement dans la documentation Visual Studio 2012

Vous pouvez exécuter le débogueur distant en copiant msvsmon.exe sur l’ordinateur distant, au lieu d’installer les outils distants. Toutefois, l’Assistant Configuration du débogueur distant (rdbgwiz.exe) est disponible uniquement lorsque vous installez les outils distants. 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.

Notes

  • 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 distants.
  • Pour déboguer des applications Windows 10 sur des appareils Windows RT, utilisez ARM, disponible uniquement dans le téléchargement des outils distants Visual Studio 2015.

Spécifications

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 le 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

Notes

Windows Phone nécessite une connexion USB pour déboguer (elle ne nécessite pas les outils distants).

Configurations matérielles prises en charge

  • Processeur 1,6 GHz minimum

  • 1 Go de RAM (1,5 Go s’il s’agit d’une machine virtuelle)

  • 1 Go d'espace disque disponible

  • Disque dur 5 400 tours/min

  • Carte vidéo DirectX 9 s’exécutant avec une résolution d’affichage de 1024 x 768 ou supérieure

Configuration réseau

L’ordinateur distant et l’ordinateur Visual Studio doivent être connectés sur un réseau, un groupe de travail, un groupe résidentiel ou directement connectés à l’aide d’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, telle que l’Internet rendez-vous, ou sur Internet entre les pays n’est pas recommandé et peut échouer ou être inceptiblement 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 à distance 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 (Utilisation de l’aide > dans le débogueur distant).

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

    Program Files\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

    Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exe

    Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\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 d’installation.

Conseil

Pour obtenir des informations de référence sur l’installation de la ligne de commande et la ligne de commande, consultez la page d’aide pour msvsmon.exe en tapant msvsmon.exe /? dans la ligne de commande sur l’ordinateur avec Visual Studio installé (ou accédez à l’utilisation de l’aide > 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 Débogueur distant et 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é), la boîte de dialogue Configuration du débogage à distance s’affiche.

    Remote Debugger configuration

  3. Si l’API Windows services web n’est pas installée, ce qui se produit uniquement sur Windows Server 2008 R2, sélectionnez le bouton Installer.

  4. Sélectionnez au moins un type de réseau sur lequel vous souhaitez utiliser les outils distants. Si les ordinateurs sont connectés à un domaine, vous devez choisir le premier élément. Si les ordinateurs sont connectés via un groupe de travail ou un groupe d’accueil, choisissez le deuxième ou le troisième élément approprié.

  5. Sélectionnez Configurer le débogage à distance pour configurer le pare-feu et démarrer le débogueur distant.

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

    Remote Debugger window

    Remote Debugger window

    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 connexion à distance dans Visual Studio.

Pour arrêter le débogueur distant, sélectionnezQuitter le fichier>. 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 après l’avoir démarré pour la première fois.

  • Si vous devez ajouter des autorisations pour d’autres utilisateurs pour se connecter au débogueur distant, choisissez Autorisations d’outils>. 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 username> : 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’expiration pour les outils distants : choisissez Options des >outils.

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

    Avertissement

    Vous pouvez choisir d'exécuter les outils de contrôle à distance en mode Aucune authentification, mais ce mode est fortement déconseillé. Il n'existe aucune sécurité du réseau lorsque vous lancez l'exécution dans ce mode. Sélectionnez le mode Aucune authentification uniquement si vous êtes sûr que le réseau n’est pas exposé à des failles de sécurité liées à des programmes malveillants ou du trafic dangereux.

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

Pour le débogage dans ASP.NET et d’autres environnements serveurs, vous devez exécuter le débogueur distant en tant qu’administrateur ou, si vous le souhaitez toujours en cours d’exécution, exécuter 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 Remote Debugger (rdbgwiz.exe). (Il s’agit d’une application distincte du débogueur distant.) Il est disponible uniquement lorsque vous installez les outils distants. Il n’est pas installé avec Visual Studio.

  2. Démarrez l’Assistant Configuration. Quand 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 le mot de passe.

    Vous devrez peut-être ajouter le droit de connexion en tant qu’utilisateur de service à ce compte (Rechercher la stratégie de sécurité locale (secpol.msc) dans la page d’accueil ou la fenêtre (ou tapez secpol à une invite de commandes). Quand la fenêtre s’affiche, double-cliquez sur Attribution des droits utilisateur, puis recherchez Ouvrir une session en tant que service dans le volet droit. Double-cliquez dessus. Ajoutez le compte d’utilisateur à la fenêtre Propriétés et cliquez sur OK). Cliquez sur Suivant.

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

  6. Si le service peut être démarré, le message suivant s’affiche : L’Assistant Configuration Visual Studio Remote Debugger est terminé. Si le service ne peut pas être démarré, le message suivant s’affiche : Échec de l’Assistant Configuration Débogueur distant Visual Studio. La page fournit également des conseils à suivre pour faire 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 de débogueur distant à partir de Panneau de configuration > Services.

Configurer le débogage avec des symboles distants

Vous devez pouvoir déboguer votre code avec les symboles que vous générez sur l’ordinateur Visual Studio. Les performances du débogueur distant sont nettement meilleures quand 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.

À partir de Visual Studio 2013 Update 2, 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 de débogage à distance (appuyez sur F1 dans la fenêtre du débogueur distant, ou cliquez sur Utilisation de l’aide>). D’autres informations sont disponibles dans Modification du chargement des symboles distants .NET dans Visual Studio 2012 et 2013.

Voir aussi