Débogage distant ASP.NET sur un ordinateur distant IISRemote Debug ASP.NET on a Remote IIS Computer

Pour déboguer une application ASP.NET qui a été déployée sur IIS, installer et exécuter les outils à distance sur l’ordinateur où vous avez déployé votre application puis attachez à votre application en cours d’exécution à partir de Visual Studio.To debug an ASP.NET application that has been deployed to IIS, install and run the remote tools on the computer where you deployed your app, and then attach to your running app from Visual Studio.

Composants du débogueur distantRemote debugger components

Ce guide explique comment installer et configurer une application Visual Studio 2017 ASP.NET MVC 4.5.2, déployez-le sur IIS et attacher le débogueur distant à partir de Visual Studio.This guide explains how to set up and configure a Visual Studio 2017 ASP.NET MVC 4.5.2 application, deploy it to IIS, and attach the remote debugger from Visual Studio. Pour déboguer à distance ASP.NET Core, consultez Core d’ASP.NET déboguer à distance sur un ordinateur IIS.To remote debug ASP.NET Core, see Remote Debug ASP.NET Core on an IIS Computer. Pour le Service d’applications Azure, vous pouvez facilement déployer et déboguer sur une instance préconfigurée de IIS à l’aide du instantané débogueur (.NET 4.6.1 requis) ou par attacher le débogueur à partir de l’Explorateur de serveurs.For Azure App Service, you can easily deploy and debug on a preconfigured instance of IIS using either the Snapshot Debugger (.NET 4.6.1 required) or by attaching the debugger from Server Explorer.

Ces procédures ont été testées sur ces configurations de serveur :These procedures have been tested on these server configurations:

  • Windows Server 2012 R2 et IIS 8 (pour Windows Server 2008 R2, les étapes de serveur sont différentes)Windows Server 2012 R2 and IIS 8 (For Windows Server 2008 R2, the server steps are different)

SpécificationsRequirements

Le débogueur distant est pris en charge sur Windows Server depuis Windows Server 2008 Service Pack 2.The remote debugger is supported on Windows Server starting with Windows Server 2008 Service Pack 2. Pour obtenir une liste complète des conditions requises, consultez exigences.For a complete list of requirements, see Requirements.

Note

Débogage entre deux ordinateurs connectés via un proxy n’est pas pris en charge.Debugging between two computers connected through a proxy is not supported. Débogage sur une latence élevée ou d’une connexion à faible bande passante, telles que les connexions à distance d’Internet, ou via Internet entre des pays n’est pas recommandé et peut échouer ou être trop faibles.Debugging over a high latency or low-bandwidth connection, such as dialup Internet, or over the Internet across countries is not recommended and may fail or be unacceptably slow.

Créer ASP.NET 4.5.2 application sur l’ordinateur Visual StudioCreate the ASP.NET 4.5.2 application on the Visual Studio computer

  1. Créez une application ASP.NET MVC.Create a new MVC ASP.NET application. (Fichier > Nouveau > projet, puis sélectionnez ** Visual c# > Web > Application Web ASP.NET.(File > New > Project, then select Visual C# > Web > ASP.NET Web Application. Dans la section des modèles **ASP.NET 4.5.2 , sélectionnez MVC.In the ASP.NET 4.5.2 templates section, select MVC. Assurez-vous que activer la prise en charge Docker n’est pas sélectionnée et que authentification a la valeur aucune authentification.Make sure that Enable Docker Support is not selected and that Authentication is set to No Authentication. Nommez le projet MyASPApp.)Name the project MyASPApp.)

  2. Ouvrez le fichier HomeController.cs et définissez un point d’arrêt dans la méthode About() .Open the HomeController.cs file, and set a breakpoint in the About() method.

Installer et configurer IIS sur Windows ServerInstall and Configure IIS on Windows Server

Ces étapes indiquent uniquement une configuration de base d’IIS.These steps show only a basic configuration of IIS. Pour plus d’informations ou pour installer sur un ordinateur de bureau Windows, consultez publication sur IIS ou IIS 8.0 à l’aide de ASP.NET 3.5 et ASP.NET 4.5.For more in-depth information or to install to a Windows Desktop machine, see Publishing to IIS or IIS 8.0 Using ASP.NET 3.5 and ASP.NET 4.5.

Pour les systèmes d’exploitation Windows, utilisez le Ajout de rôles et fonctionnalités Assistant via la gérer lien ou le tableau de bord lien dans leGestionnairedeserveur.For Windows Server operating systems, use the Add Roles and Features wizard via the Manage link or the Dashboard link in Server Manager. À l’étape Rôles de serveurs, cochez la case Serveur Web (IIS).On the Server Roles step, check the box for Web Server (IIS).

Le rôle Serveur Web IIS est sélectionné à l’étape Sélectionner des rôles de serveurs.

À l’étape Services de rôle, sélectionnez les services de rôle IIS souhaités ou acceptez les services de rôle par défaut.On the Role services step, select the IIS role services you desire or accept the default role services provided.

Exécutez les étapes de confirmation pour installer les services et le rôle de serveur web.Proceed through the confirmation steps to install the web server role and services. Un redémarrage du serveur/d’IIS n’est pas nécessaire après l’installation du rôle Serveur Web (IIS).A server/IIS restart is not required after installing the Web Server (IIS) role.

Mettre à jour les paramètres de sécurité de navigateur sur Windows ServerUpdate browser security settings on Windows Server

En fonction de vos paramètres de sécurité, il peut gagner du temps d’ajouter les sites de confiance suivants à votre navigateur vous pouvez facilement télécharger le logiciel décrit dans ce didacticiel.Depending on your security settings, it may save you time to add the following trusted sites to your browser so you can easily download the software described in this tutorial. Accès à ces sites peuvent être nécessaires :Access to these sites may be needed:

  • Microsoft.commicrosoft.com
  • go.microsoft.comgo.microsoft.com
  • download.microsoft.comdownload.microsoft.com
  • visualstudio.comvisualstudio.com

Si vous utilisez Internet Explorer, vous pouvez ajouter les sites de confiance en accédant à Options Internet > sécurité > Sites de confiance > Sites.If you are using Internet Explorer, you can add the trusted sites by going to Internet Options > Security > Trusted Sites > Sites. Ces étapes sont différents pour d’autres navigateurs.These steps are different for other browsers. (Si vous avez besoin télécharger une version antérieure du débogueur distant à partir de my.visualstudio.com, certains sites de confiance supplémentaires sont requis pour se connecter).(If you need to download an older version of the remote debugger from my.visualstudio.com, some additional trusted sites are required to sign in.)

Lorsque vous téléchargez le logiciel, vous pouvez obtenir des demandes pour accorder des autorisations requises pour charger les différents scripts de site web et des ressources.When you download the software, you may get requests to grant permission to load various web site scripts and resources. Dans la plupart des cas, les ressources supplémentaires suivantes ne sont pas requis pour installer le logiciel.In most cases, these additional resources are not required to install the software.

Installez ASP.NET 4.5 sur Windows ServerInstall ASP.NET 4.5 on Windows Server

Si vous souhaitez des informations plus détaillées pour installer ASP.NET sur IIS, consultez IIS 8.0 à l’aide de ASP.NET 3.5 et ASP.NET 4.5.If you want more detailed information to install ASP.NET on IIS, see IIS 8.0 Using ASP.NET 3.5 and ASP.NET 4.5.

  1. Web Platform Installer (WebPI) permet d’installer ASP.NET 4.5 (à partir du nœud de serveur dans Windows Server 2012 R2, choisissez obtenir nouveaux composants Web Platform , puis recherchez ASP.NET)Use the Web Platform Installer (WebPI) to install ASP.NET 4.5 (from the Server node in Windows Server 2012 R2, choose Get New Web Platform Components and then search for ASP.NET)

    RemoteDBG_IIS_AspNet_45RemoteDBG_IIS_AspNet_45

    Note

    Si vous utilisez Windows Server 2008 R2, installez ASP.NET 4 au lieu d’utiliser cette commande :If you are using Windows Server 2008 R2, install ASP.NET 4 instead using this command:

    C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -irC:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -ir

  2. Redémarrer le système (ou exécutez net stop a été /y suivie net démarrer w3svc à partir d’une invite de commandes pour voir une modification dans le chemin d’accès du système).Restart the system (or execute net stop was /y followed by net start w3svc from a command prompt to pick up a change to the system PATH).

(Facultatif) Installation Web déployer 3.6 sur Windows Server(Optional) Install Web Deploy 3.6 on Windows Server

  1. Si vous prévoyez de déployer vos applications avec Web Deploy dans Visual Studio, installez la dernière version de Web Deploy sur le serveur.If you intend to deploy your applications with Web Deploy in Visual Studio, install the latest version of Web Deploy on the server.

    Pour installer Web Deploy, utilisez le Web Platform Installer (WebPI).To install Web Deploy, use the Web Platform Installer (WebPI). Rechercher le déploiement Web dans l’onglet Applications. Vous pouvez également obtenir un programme d’installation directement à partir de la Microsoft Download Center.You find Web Deploy in the Applications tab. You can also obtain an installer directly from the Microsoft Download Center.

  2. Vérifiez que Web Deploy s’exécute correctement en ouvrant le panneau de configuration > système et sécurité > Outils d’administration > Services et assurez-vous que Service de l’Agent de déploiement Web est en cours d’exécution (la nom du service est différent dans les versions antérieures).Verify that Web Deploy is running correctly by opening Control Panel > System and Security > Administrative Tools > Services and make sure that Web Deployment Agent Service is running (the service name is different in older versions).

    Si le service agent n’est pas en cours d’exécution, démarrez-le.If the agent service is not running, start it. Si elle ne figure pas du tout, accédez à le panneau de configuration > Programmes > désinstaller un programme, recherchez Microsoft Web Deploy .If it is not present at all, go to Control Panel > Programs > Uninstall a program, find Microsoft Web Deploy . Choisissez de modification l’installation et vérifiez que vous choisissez sera installé sur le disque dur local pour les composants Web Deploy.Choose to Change the installation and make sure that you choose Will be installed to the local hard drive for the Web Deploy components. Effectuez les étapes d’installation de modification.Complete the change installation steps.

Configurer le site Web ASP.NET sur l’ordinateur Windows ServerConfigure ASP.NET Web site on the Windows Server computer

  1. Ouvrez l’Explorateur Windows et créez un dossier, C:\Publish, où vous déploierez plus tard le projet ASP.NET.Open Windows Explorer and create a new folder, C:\Publish, where you will later deploy the ASP.NET project.

  2. Ouvrez le Internet Information Services (IIS) Manager.Open the Internet Information Services (IIS) Manager. (Dans le volet gauche du Gestionnaire de serveur, sélectionnez IIS.(In the left pane of Server Manager, select IIS. Cliquez sur le serveur et sélectionnez Gestionnaire des Services Internet (IIS).)Right-click the server and select Internet Information Services (IIS) Manager.)

  3. Sous connexions dans le volet gauche, accédez à Sites.Under Connections in the left pane, go to Sites.

  4. Sélectionnez le Site Web par défaut, choisissez les paramètres de baseet définissez la chemin d’accès physique à C:\Publish.Select the Default Web Site, choose Basic Settings, and set the Physical path to C:\Publish.

  5. Cliquez avec le bouton droit sur le nœud Site web par défaut et sélectionnez Ajouter une application.Right-click the Default Web Site node and select Add Application.

  6. Définir le Alias au champ MyASPApp, acceptez la valeur par défaut du Pool d’applications (DefaultAppPool) et définissez la chemin d’accès physique à C:\Publish.Set the Alias field to MyASPApp, accept the default Application Pool (DefaultAppPool), and set the Physical path to C:\Publish.

  7. Sous connexions, sélectionnez Pools d’applications.Under Connections, select Application Pools. Ouvrez DefaultAppPool et la valeur du champ de pool d’applications ASP.NET v4.0 (ASP.NET 4.5 n’est pas une option pour le pool d’applications).Open DefaultAppPool and set the Application pool field to ASP.NET v4.0 (ASP.NET 4.5 is not an option for the Application pool).

  8. Le site sélectionné dans le Gestionnaire des services Internet, choisissez modifier les autorisationset assurez-vous que IUSR, IIS_IUSRS ou l’utilisateur configuré pour le Pool d’applications est un utilisateur autorisé avec des droits de lecture et exécution.With the site selected in the IIS Manager, choose Edit Permissions, and make sure that IUSR, IIS_IUSRS, or the user configured for the Application Pool is an authorized user with Read & Execute rights. Si aucun de ces utilisateurs sont présentes, ajoutez IUSR en tant qu’utilisateur avec des droits de lecture et exécution.If none of these users are present, add IUSR as a user with Read & Execute rights.

(Facultatif) Publier et déployer l’application à l’aide de Web Deploy à partir de Visual Studio(Optional) Publish and deploy the app using Web Deploy from Visual Studio

Si vous avez installé le déploiement Web à l’aide de Web Platform Installer, vous pouvez déployer l’application directement à partir de Visual Studio.If you installed Web Deploy using the Web Platform Installer, you can deploy the app directly from Visual Studio.

  1. Démarrez Visual Studio avec des privilèges d’administrateur et rouvrez le projet.Start Visual Studio with Administrator privileges, and reopen the project.

    Des privilèges d’administrateur sont requis pour déployer votre application à l’aide de Web Deploy.Administrator privileges are required to deploy your app using Web Deploy.

  2. Dans l’ Explorateur de solutions, cliquez avec le bouton droit sur le nœud de projet et sélectionnez Publier.In the Solution Explorer, right-click the project node and select Publish.

  3. Pour sélectionner une cible de publication, sélectionnez IIS, FTP, etc. et cliquez sur publier.For Select a publish target, select IIS, FTP, etc. and click Publish.

    RemoteDBG_Publish_IISlRemoteDBG_Publish_IISl

  4. Entrez les paramètres de configuration de correction pour l’installation d’IIS.Enter the correction configuration parameters for your IIS setup.

    RemoteDBG_Publish_WebDeploylRemoteDBG_Publish_WebDeployl

    Si un nom d’hôte ne résout pas lorsque vous essayez de validation en suivant les étapes le Server texte zone, essayez de l’adresse IP.If a host name doesn't resolve when you try to validate in the next steps in the Server text box, try the IP address. Inclure http:// en tant que préfixe dans le Server champ.Include http:// as a prefix in the Server field. Assurez-vous que vous utilisez le port 80 dans le Server texte zone et vous assurer que le port 80 est ouvert dans le pare-feu.Make sure you use port 80 in the Server text box, and make sure that port 80 is open in the firewall.

  5. Cliquez sur suivant, choisissez un déboguer configuration, choisissez supprimer les fichiers supplémentaires à la destination sous le fichier publier Options.Click Next, choose a Debug configuration, and choose Remove additional files at destination under the File Publish options.

    Note

    Si vous choisissez une configuration Release, vous désactivez le débogage dans le fichier web.config lorsque vous publiez.If you choose a Release configuration, you disable debugging in the web.config file when you publish.

  6. Cliquez sur Prev, puis choisissez Validate.Click Prev, and then choose Validate. Si le programme d’installation de connexion valide, essayez de publier.If the connection setup validates, you can try to publish.

  7. Cliquez sur publier pour publier l’application.Click Publish to publish the app.

    L’onglet sortie vous indique si la publication a réussi, et l’application ouvre votre navigateur.The Output tab shows you if publishing is successful, and your browser then opens the app.

    Si vous obtenez une erreur mentionnant Web Deploy, vérifiez à nouveau les étapes d’installation Web Deploy et assurez-vous que les ports appropriés sont ouverts (Web Deploy requiert également le port 8172 ouvert sur le serveur).If you get an error mentioning Web Deploy, recheck the Web Deploy installation steps and make sure the correct ports are open (Web Deploy also requires port 8172 to be open on the server).

    Si l’application se déploie correctement, mais elle ne s’exécute pas correctement, il peut y avoir un problème avec votre configuration IIS, l’installation d’ASP.NET ou la configuration de votre site Web.If the app deploys successfully but doesn't run correctly, there may be an issue with your IIS configuration, your ASP.NET installation, or your Web site configuration. Sur le serveur Windows, ouvrez le site Web d’IIS pour les messages d’erreur plus spécifiques et puis revérifiez les étapes précédentes.On the Windows Server, open the Web site from IIS for more specific error messages, and then recheck earlier steps.

En outre, vous devez lire la section sur résolution des problèmes de ports.Also, you may need to read the section on Troubleshooting ports.

(Facultatif) Publier et déployer l’application en publiant dans un dossier local à partir de Visual Studio(Optional) Publish and Deploy the app by publishing to a local folder from Visual Studio

Vous pouvez également publier et déployer l’application à l’aide du système de fichiers ou d’autres outils.You can also publish and deploy the app using the file system or other tools.

  1. (ASP.NET 4.5.2) Assurez-vous que le fichier web.config indique la version correcte du .NET Framework.(ASP.NET 4.5.2) Make sure that the web.config file lists the correct version of the .NET Framework. Par exemple, si vous ciblez ASP.NET 4.5.2, assurez-vous que cette version est répertoriée dans le fichier web.config.For example, if you are targeting ASP.NET 4.5.2, make sure this version is listed in web.config.

    <system.web>
      <compilation debug="true" targetFramework="4.5.2" />
      <httpRuntime targetFramework="4.5.2" />
      <httpModules>
        <add name="ApplicationInsightsWebTracking" type="Microsoft.ApplicationInsights.Web.ApplicationInsightsHttpModule, Microsoft.AI.Web" />
      </httpModules>
    </system.web>
    

    Par exemple, la version doit être 4.0 si vous installez ASP.NET 4 au lieu de 4.5.2.For example, the version should be 4.0 if you install ASP.NET 4 instead of 4.5.2.

  1. Dans le l’Explorateur de solutions, cliquez sur le nœud du projet et sélectionnez publier (pour Web Forms, publier l’application Web).In the Solution Explorer, right-click the project node and select Publish (for Web Forms, Publish Web App).

  2. Dans le publier boîte de dialogue, sélectionnez dossier, cliquez sur Parcouriret créer un nouveau dossier, C:\Publish.In the Publish dialog box, select Folder, click Browse, and create a new folder, C:\Publish.

    RemoteDBG_Publish_LocalRemoteDBG_Publish_Local

    Pour une application Web Forms, choisissez personnalisé dans la boîte de dialogue Publier, entrez un nom de profil, puis choisissez OK.For a Web Forms app, choose Custom in the Publish dialog box, enter a profile name, and choose OK.

  3. Cliquez sur Publier.Click Publish.

    Visual Studio publie le projet dans le dossier.Visual Studio publishes the project to the folder. Progression s’affiche dans la fenêtre Sortie.Progress shows in the Output window.

  4. Dans le publier boîte de dialogue, cliquez sur le paramètres lier, puis sélectionnez le paramètres onglet.In the Publish dialog box, click the Settings link, and then select the Settings tab.

  5. La configuration de la valeur déboguer, sélectionnez supprimer tous les fichiers existants avant de publier, puis cliquez sur enregistrer.Set the configuration to Debug, select Delete all existing files prior to publish, and then click Save.

    Note

    Si vous utilisez une version Release, vous désactivez le débogage dans le fichier web.config lorsque vous publiez.If you use a Release build, you disable debugging in the web.config file when you publish.

  6. Cliquez sur Publier.Click Publish.

    RemoteDBG_Publish_Debug_ConfigRemoteDBG_Publish_Debug_Config

    L’application publie un déboguer configuration du projet dans le dossier local.The application publishes a Debug configuration of the project to the local folder.

  7. Copiez le répertoire du projet ASP.NET à partir de l’ordinateur Visual Studio dans le répertoire local est configuré pour l’application ASP.NET (dans cet exemple, C:\Publish) sur l’ordinateur Windows Server.Copy the ASP.NET project directory from the Visual Studio computer to the local directory configured for the ASP.NET app (in this example, C:\Publish) on the Windows Server computer. Dans ce didacticiel, nous supposons que vous copiez manuellement, mais vous pouvez utiliser d’autres outils tels que PowerShell, Xcopy ou Robocopy.In this tutorial, we assume you are copying manually, but you can use other tools like PowerShell, Xcopy, or Robocopy.

    Attention

    Si vous devez apporter des modifications à du code ou la régénération, vous devez republier et répétez cette étape.If you need to make changes to the code or rebuild, you must republish and repeat this step. Le fichier exécutable que vous avez copié sur l’ordinateur distant doit correspondre exactement à la source et aux symboles locaux.The executable you copied to the remote machine must exactly match your local source and symbols. Si vous ne le faites pas vous recevrez un cannot find or open the PDB file avertissement dans Visual Studio lorsque vous essayez de déboguer le processus.If you do not do this you will receive a cannot find or open the PDB file warning in Visual Studio when you attempt to debug the process.

  8. Sur le serveur Windows, vérifiez que vous pouvez exécuter l’application correctement en ouvrant l’application dans votre navigateur.On the Windows Server, verify that you can run the app correctly by opening the app in your browser.

    Si l’application ne s’exécute pas correctement, il peut y avoir une incompatibilité entre la version d’ASP.NET installés sur votre serveur et sur votre ordinateur Visual Studio, ou vous pouvez avoir un problème avec votre configuration d’IIS ou le site Web.If the app doesn't run correctly, there may be a mismatch between the version of ASP.NET installed on your server and your Visual Studio machine, or you may have an issue with your IIS or Web site configuration. Revérifier les étapes précédentes.Recheck earlier steps.

Téléchargez et installez les outils à distance sur Windows ServerDownload and Install the remote tools on Windows Server

Dans ce didacticiel, nous utilisons Visual Studio 2017.In this tutorial, we are using Visual Studio 2017.

  1. Sur l’appareil ou serveur ordinateur que vous souhaitez déboguer (plutôt que l’ordinateur exécutant Visual Studio), obtenir la version des outils à distance.On the device or server machine that you want to debug (rather than the machine running Visual Studio), get the correct version of the remote tools.

    VersionVersion LienLink NotesNotes
    Visual Studio 2017 (dernière version)Visual Studio 2017 (latest version) Outils à distanceRemote tools Toujours télécharger la version correspondant à votre système d’exploitation de périphérique (x86 ou x64).Always download the version matching your device operating system (x86 or x64). Si le mode de sécurité renforcée est activé (Windows Server), vous devez ajouter des sites approuvés si vous y êtes invité.If enhanced security mode is enabled (Windows Server), you must add new trusted sites if prompted.
    2017 de Visual Studio (plus ancienne)Visual Studio 2017 (older) Outils à distanceRemote tools Les outils à distance pour les versions antérieures de Visual Studio 2017 sont disponibles à partir de My.VisualStudio.com. Si vous y êtes invité, jointure du groupe Visual Studio Dev Essentials libre, ou connectez-vous avec votre abonnement Visual Studio code.Remote tools for earlier releases of Visual Studio 2017 are available from My.VisualStudio.com. If prompted, join the free Visual Studio Dev Essentials group, or sign in with your Visual Studio subscription ID. Si le mode de sécurité renforcée est activé (Windows Server), vous devez ajouter des sites approuvés si vous y êtes invité.If enhanced security mode is enabled (Windows Server), you must add new trusted sites if prompted.
    Visual Studio 2015 Update 3Visual Studio 2015 Update 3 Outils à distanceRemote tools Si vous y êtes invité, jointure du groupe Visual Studio Dev Essentials libre, ou connectez-vous avec votre abonnement Visual Studio code.If prompted, join the free Visual Studio Dev Essentials group, or sign in with your Visual Studio subscription ID. Si le mode de sécurité renforcée est activé (Windows Server), vous devez ajouter des sites approuvés si vous y êtes invité.If enhanced security mode is enabled (Windows Server), you must add new trusted sites if prompted.
    Visual Studio 2015 (plus ancienne)Visual Studio 2015 (older) Outils à distanceRemote tools Si vous y êtes invité, jointure du groupe Visual Studio Dev Essentials libre, ou connectez-vous avec votre abonnement Visual Studio code.If prompted, join the free Visual Studio Dev Essentials group, or sign in with your Visual Studio subscription ID. Si le mode de sécurité renforcée est activé (Windows Server), vous devez ajouter des sites approuvés si vous y êtes invité.If enhanced security mode is enabled (Windows Server), you must add new trusted sites if prompted.
    Visual Studio 2013Visual Studio 2013 Outils à distanceRemote tools Télécharger la page dans la documentation de Visual Studio 2013Download page in Visual Studio 2013 documentation
    Visual Studio 2012Visual Studio 2012 Outils à distanceRemote tools Télécharger la page dans la documentation de Visual Studio 2012Download page in Visual Studio 2012 documentation
  2. Sur la page de téléchargement, choisissez la version des outils qui correspond à votre système d’exploitation (x 86, x64 ou ARM) et télécharger les outils à distance.On the download page, choose the version of the tools that matches your operating system (x86, x64, or ARM) and download the remote tools.

    Important

    Nous vous recommandons de qu'installer la version la plus récente des outils à distance qui correspond à votre version de Visual Studio.We recommend you install the most recent version of the remote tools that matches your version of Visual Studio. Versions incompatibles ne sont pas recommandées.Mismatched versions are not recommended. En outre, vous devez installer les outils à distance qui ont la même architecture que le système d’exploitation sur lequel vous souhaitez l’installer.In addition, you must install the remote tools that have the same architecture as the operating system on which you want to install it. En d’autres termes, si vous souhaitez déboguer une application 32 bits sur un ordinateur distant exécutant un système d’exploitation de 64 bits, vous devez installer la version 64 bits des outils à distance sur l’ordinateur distant.In other words, if you want to debug a 32-bit application on a remote computer running a 64-bit operating system, you must install the 64-bit version of the remote tools on the remote computer.

    Surface 3 basculée ARM vers x64 architecture.Surface 3 switched from ARM to x64 architecture. Une version ARM des outils à distance n’est pas disponible pour Visual Studio 2017.An ARM version of the remote tools is not available for Visual Studio 2017. Pour Visual Studio 2015, recherchez la version ARM dans le téléchargement de la version RTW de Visual Studio 2015.For Visual Studio 2015, find the ARM version in the Visual Studio 2015 RTW download.

  3. Lorsque vous avez terminé de télécharger le fichier exécutable, accédez à la section suivante et suivez les instructions d’installation.When you have finished downloading the executable, go to the next section and follow setup instructions.

Si vous essayez de copier le débogueur distant (msvsmon.exe) à l’ordinateur distant et l’exécuter, n’oubliez pas que le Assistant Configuration Débogueur distant (rdbgwiz.exe) est installé uniquement lorsque vous téléchargez le outils.If you try to copy the remote debugger (msvsmon.exe) to the remote computer and run it, be aware that the Remote Debugger Configuration Wizard (rdbgwiz.exe) is installed only when you download the tools. Vous devrez peut-être utiliser l’Assistant de configuration plus tard, en particulier si vous souhaitez que le débogueur distant s’exécute en tant que service.You may need to use the wizard for configuration later, especially if you want the remote debugger to run as a service. Pour plus d’informations, consultez (facultatif) configurer le débogueur distant en tant que service.For more information, see (Optional) Configure the remote debugger as a service.

Conseil

Dans certains scénarios, il peut être plus efficace d’exécuter le débogueur distant à partir d’un partage de fichiers.In some scenarios, it can be most efficient to run the remote debugger from a file share. Pour plus d’informations, consultez exécuter le débogueur distant à partir d’un partage de fichiers.For more information, see Run the remote debugger from a file share.

Configurer le débogueur distant sur Windows ServerSet up the remote debugger on Windows Server

Vous devez disposer des autorisations administratives sur l’ordinateur distant.You must have administrative permissions on the remote computer.

  1. Recherchez l’application du débogueur distant.Locate the Remote Debugger application. (Rechercher msvsmon.exe à l’emplacement où il a été installé, ou ouvrez le menu Démarrer et recherchez débogueur distant.)(Find msvsmon.exe in the location where it has been installed, or open the Start menu and search for Remote Debugger.)

    Si vous exécutez le débogueur distant sur un serveur distant, vous pouvez cliquez sur l’application du débogueur distant et choisissez exécuter en tant qu’administrateur.If you are running the remote debugger on a remote server, you can right-click the Remote Debugger app and choose Run as administrator. Si vous n’exécutez pas sur un serveur distant, juste le démarrer normalement.If you are not running it on a remote server, just start it normally.

  2. Lorsque vous démarrez les outils à distance pour la première fois (ou avant que vous avez configuré), le Configuration du débogage distant boîte de dialogue s’affiche.When you start the remote tools for the first time (or before you have configured it), the Remote Debugging Configuration dialog box appears.

    RemoteDebuggerConfWizardPageRemoteDebuggerConfWizardPage

  3. Si l’API du Service Windows n’est pas installé (ce qui se produit uniquement sur Windows Server 2008 R2), choisissez le installer bouton.If the Windows Service API is not installed (which happens only on Windows Server 2008 R2), choose the Install button.

  4. Sélectionnez les types de réseau sur lesquels vous voulez utiliser les outils de contrôle à distance.Select the network types you want use the remote tools on. Au moins un type de réseau doit être sélectionné.At least one network type must be selected. Si les ordinateurs sont connectés à un domaine, vous devez choisir le premier élément.If the computers are connected through a domain, you must choose the first item. 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, selon les besoins.If the computers are connected through a workgroup or homegroup, you need to choose the second or third item as appropriate.

  5. Choisissez configurer le débogage distant pour configurer le pare-feu et démarrer l’outil.Choose Configure remote debugging to configure the firewall and start the tool.

  6. Une fois la configuration terminée, la fenêtre du débogueur distant s’affiche.When configuration is complete, the Remote Debugger window appears.

    RemoteDebuggerWindowRemoteDebuggerWindow

    Le débogueur distant est maintenant en attente pour une connexion.The remote debugger is now waiting for a connection. Prenez note du nom du serveur et le port numéro qui s’affiche, car cela doit correspondre à la configuration que vous utiliserez dans Visual Studio.Make a note of the server name and port number that is displayed, because this must match the configuration you later use in Visual Studio.

    Lorsque vous avez terminé le débogage et devoir arrêter le débogueur distant, cliquez sur fichier > quitter dans la fenêtre.When you are finished debugging and need to stop the remote debugger, click File > Exit on the window. Vous pouvez le redémarrer à partir de la Démarrer menu ou à partir de la ligne de commande :You can restart it from the Start menu or from the command line:

    <Répertoire d’installation de Visual Studio > \Common7\IDE\Remote Debugger\< x86, x64 ou Appx > \msvsmon.exe.<Visual Studio installation directory>\Common7\IDE\Remote Debugger\<x86, x64, or Appx>\msvsmon.exe.

Note

Si vous devez ajouter des autorisations pour les utilisateurs supplémentaires, modifier le mode d’authentification ou numéro de port pour le débogueur distant, consultez configurer le débogueur distant.If you need to add permissions for additional users, change the authentication mode, or port number for the remote debugger, see Configure the remote debugger.

Pour plus d’informations sur l’exécution du débogueur distant en tant que service, consultez exécuter le débogueur distant en tant que service.For information on running the remote debugger as a service, see Run the remote debugger as a service.

Attachement à l’application ASP.NET à partir de l’ordinateur Visual StudioAttach to the ASP.NET application from the Visual Studio computer

  1. Sur l’ordinateur Visual Studio, ouvrez le MyASPApp solution.On the Visual Studio computer, open the MyASPApp solution.
  2. Dans Visual Studio, cliquez sur Déboguer > Attacher au processus (Ctrl + Alt + P).In Visual Studio, click Debug > Attach to Process (Ctrl + Alt + P).

    Conseil

    Dans Visual Studio 2017, vous pouvez rattacher au même processus vous précédemment attaché à l’aide de Déboguer > rattacher à un processus en cours... (Maj + Alt + P).In Visual Studio 2017, you can reattach to the same process you previously attached to by using Debug > Reattach to Process... (Shift+Alt+P).

  3. Définissez le champ qualificateur sur <nom_ordinateur_distant > : 4022.Set the Qualifier field to <remote computer name>:4022.

  4. Cliquez sur Actualiser.Click Refresh. Des processus doivent s’afficher dans la fenêtre Processus disponibles .You should see some processes appear in the Available Processes window.

    Si vous ne voyez pas tous les processus, essayez d’utiliser l’adresse IP au lieu du nom de l’ordinateur distant (le port est requis).If you don't see any processes, try using the IP address instead of the remote computer name (the port is required). Vous pouvez utiliser ipconfig dans une ligne de commande pour obtenir l’adresse IPv4.You can use ipconfig in a command line to get the IPv4 address.

  5. Cochez Afficher les processus de tous les utilisateurs.Check Show processes from all users.

  6. Tapez la première lettre d’un nom de processus pour rechercher rapidement w3wp.exe pour ASP.NET 4.5.Type the first letter of a process name to quickly find w3wp.exe for ASP.NET 4.5.

    RemoteDBG_AttachToProcessRemoteDBG_AttachToProcess

  7. Cliquez sur attacherClick Attach

  8. Ouvrez le site web de l’ordinateur distant.Open the remote computer's website. Dans un navigateur, accédez à http://<nom_ordinateur_distant >.In a browser, go to http://<remote computer name>.

    La page web ASP.NET doit s’afficher.You should see the ASP.NET web page.

  9. Dans l’application ASP.NET en cours d’exécution, cliquez sur le lien vers le sur page.In the running ASP.NET application, click the link to the About page.

    Le point d’arrêt doit être atteint dans Visual Studio.The breakpoint should be hit in Visual Studio.

Résolution des problèmes : Ouvrir les ports requis sur Windows ServerTroubleshooting: Open required ports on Windows Server

Dans la plupart des configurations, les ports requis sont ouverts par l’installation d’ASP.NET et le débogueur distant.In most setups, required ports are opened by the installation of ASP.NET and the remote debugger. Toutefois, vous devrez peut-être vérifier que les ports sont ouverts.However, you may need to verify that ports are open.

Note

Sur une machine virtuelle Azure, vous devez ouvrir les ports via la groupe de sécurité réseau.On an Azure VM, you must open ports through the Network security group.

Ports requis :Required ports:

  • 80 - requis pour IIS80 - Required for IIS
  • 8172 - (facultatif) requis pour Web Deploy déployer l’application à partir de Visual Studio8172 - (Optional) Required for Web Deploy to deploy the app from Visual Studio
  • 4022 - requis pour le débogage distant à partir de Visual Studio 2017 (consultez affectations de Port du débogueur distant pour plus d’informations.4022 - Required for remote debugging from Visual Studio 2017 (see Remote Debugger Port Assignments for detailed information.
  • UDP 3702 - port de détection de (facultatif) vous permet du trouver bouton lors de l’attachement du débogueur distant dans Visual Studio.UDP 3702 - (Optional) Discovery port enables you to the Find button when attaching to the remote debugger in Visual Studio.
  1. Pour ouvrir un port sur Windows Server, ouvrez le Démarrer menu, recherchez pare-feu Windows avec fonctions avancées de sécurité.To open a port on Windows Server, open the Start menu, search for Windows Firewall with Advanced Security.

  2. Puis choisissez règles de trafic entrant > nouvelle règle > Port.Then choose Inbound Rules > New Rule > Port. Choisissez suivant et sous ports locaux spécifiques, entrez le numéro de port, cliquez sur suivant, puis autoriser la connexion, cliquez sur Suivant, et Ajoutez le nom (IIS, Web Deploy, ou msvsmon) pour la règle de trafic entrant.Choose Next and under Specific local ports, enter the port number, click Next, then Allow the Connection, click Next, and add the name (IIS, Web Deploy, or msvsmon) for the Inbound Rule.

    Si vous souhaitez plus d’informations sur la configuration du pare-feu Windows, consultez configurer le pare-feu Windows pour le débogage distant.If you want more details on configuring Windows Firewall, see Configure the Windows Firewall for Remote Debugging.

  3. Créer des règles supplémentaires pour les autres ports requis.Create additional rules for the other required ports.