Comment : installer le débogage distant
Cette rubrique s'applique à :
Édition |
Visual Basic |
C# |
F# |
C++ |
Web Developer |
---|---|---|---|---|---|
Express |
|||||
Pro, Premium et Ultimate |
Pour activer le débogage distant, vous pouvez procéder comme suit :
Installer les composants de débogage distant sur l'ordinateur distant et lancer Remote Debugging Monitor (msvsmon.exe) lorsque vous commencez à déboguer
- ou -
Exécuter à distance Remote Debugging Monitor à partir d'un partage.
L'exécution de Remote Debugging Monitor à partir d'un partage de fichiers est la façon la plus facile d'activer le débogage distant.
Lorsque vous installez Visual Studio sur une plateforme 64 bits, les versions de Remote Debugging Monitor pour les trois architectures sont copiées dans le dossier :
Chemin d'installation\Microsoft Visual Studio 10.0\Common7\IDE\Remote Debugger
Pour installer les autres composants de débogage distant, suivez la procédure décrite dans cette rubrique.
Si vous partagez le dossier Remote Debugger sur l'ordinateur Visual Studio, vous pouvez exécuter msvsmon.exe sur l'ordinateur distant. Les scénarios suivants nécessitent l'installation des composants de débogage distant sur l'ordinateur distant :
Exécution pas à pas d'un service hébergé appelé par un client WCF.
Débogage automatique d'une application Web ASP.NET.
Dans les deux cas, l'attachement manuel est possible sans installer les composants sur l'ordinateur distant.
Comme alternative à l'exécution depuis un partage, vous pouvez installer les composants de débogage distant requis sur l'ordinateur distant. Cette installation fournit l'accès à toutes les fonctionnalités de débogage distant. Lorsque vous installez le Débogueur distant sur une plateforme x86, seuls les composants de débogage distant x86 sont installés. Aucune option ne permet d'installer les composants 64 bits. Si vous l'installez sur une plateforme 64 bits, les composants x86 et 64 bits sont installés.
Pour installer les composants de débogage distant
Le débogueur distant est disponible sur le DVD d'installation Visual Studio.
Dans l'Explorateur Windows, ouvrez le DVD et recherchez vs/Remote Debugger.
Dans le dossier vs/Remote Debugger, lancez le programme d'installation du débogueur distant Microsoft Visual Studio 2010 adapté à votre plateforme : rdbgsetup_x86, rdbgsetup_x64 ou rdbgsetup_ia64.
Suivez les instructions de l'Assistant Installation du débogueur distant pour effectuer l'installation.
Si vous préférez, vous pouvez installer les composants de débogage distant en copiant les fichiers manuellement. Consultez Composants du débogage distant pour obtenir la liste des composants requis et leurs emplacements d'installation. Visual Studio inclut des versions distinctes de Remote Debugging Monitor destinées aux plateformes 32 bits et 64 bits. Si vous utilisez le programme d'installation du débogueur distant, la version adaptée de Remote Debugging Monitor sera installée automatiquement. Toutefois, si vous copiez les fichiers manuellement, assurez-vous de copier la version appropriée.
Après avoir installé les composants de débogage distant, vous devez vérifier que vous disposez des autorisations requises pour déboguer un programme sur l'ordinateur distant. Consultez Autorisations de débogage distant pour obtenir la liste des autorisations requises.
Configuration du Pare-feu Windows
Le Pare-feu Windows doit être configuré pour activer le débogage distant. Lors du premier débogage distant, Visual Studio exécute la configuration nécessaire sur l'ordinateur hôte Visual Studio. Lorsque vous exécutez Remote Debugging Monitor sur un ordinateur distant pour la première fois, Remote Debugging Monitor configure le Pare-feu Windows à cette fin.
Sous Windows XP, cette configuration est complètement transparente et automatique. Toutefois, sous Windows Vista, le nouveau modèle de sécurité vous impose d'accorder l'autorisation avant que le logiciel puisse configurer le pare-feu. Cette autorisation est accordée à l'aide de la boîte de dialogue Contrôle de compte d'utilisateur. Pour obtenir la description du nouveau modèle de sécurité et du contrôle d'accès d'utilisateur, consultez Modèle de sécurité Windows.
Lorsque Remote Debugging Monitor doit configurer le Pare-feu Windows sur l'ordinateur distant, la boîte de dialogue Contrôle d'accès d'utilisateur s'affiche sur l'ordinateur distant. Si l'ordinateur distant n'est pas visible, vous pouvez ne pas vous rendre compte que la boîte de dialogue Contrôle de compte d'utilisateur s'est affichée sur l'écran. Dans ce cas, vous pouvez penser par erreur que le débogage distant ne répond plus. En réalité, Remote Debugging Monitor attend simplement qu'un utilisateur accorde l'autorisation Contrôle de compte d'utilisateur sur l'ordinateur distant.
Il est très peu probable que le Pare-feu Windows doive être configuré manuellement. Toutefois, si vous le configurez manuellement, consultez Comment : configurer manuellement le Pare-feu Windows 7 pour le débogage à distance, Comment : configurer manuellement le Pare-feu Windows Vista pour le débogage distant ou Comment : configurer manuellement le Pare-feu Windows XP pour le débogage distant.
-
Débogage du serveur Web
Pour activer le débogage du serveur Web sur Windows Vista ou Windows XP SP2
Pour activer le débogage du serveur Web sur Windows Vista ou sur Windows XP, vous devez exécuter des étapes supplémentaires.
Pour Windows 7, consultez Comment : activer le débogage du serveur Web sur Windows 7.
Pour Windows Vista, consultez Comment : activer le débogage du serveur Web sur Windows Vista.
Pour Windows XP SP2, consultez Comment : activer le débogage du serveur Web sur Windows XP.
Démarrage du débogage distant
Pour démarrer le débogage distant
Assurez-vous que vous disposez des autorisations de débogage distant nécessaires sur l'ordinateur distant. Pour plus d'informations, consultez Autorisations de débogage distant.
Pour un débogage distant autre que SQL, assurez-vous d'exécuter Remote Debugging Monitor sur l'ordinateur distant. Pour plus d'informations, consultez Comment : exécuter Remote Debugging Monitor. Lors du débogage SQL, Remote Debugging Monitor se lance automatiquement pendant le débogage.
Lancez Visual Studio sur l'hôte du débogueur.
À l'aide de Visual Studio, attachez ou lancez le programme que vous souhaitez déboguer sur l'ordinateur distant. Pour plus d'informations, consultez Comment : attacher à un processus en cours d'exécution.
Voir aussi
Tâches
Erreurs de débogage distant et dépannage