Débogage distant ASP.NET Core sur un ordinateur IIS distant dans Visual Studio 2017Remote Debug ASP.NET Core on a Remote IIS Computer in Visual Studio 2017

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 un Visual Studio 2017 ASP.NET Core, 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 Core, deploy it to IIS, and attach the remote debugger from Visual Studio. Pour déboguer à distance ASP.NET 4.5.2, consultez ASP.NET de déboguer à distance sur un ordinateur IIS.To remote debug ASP.NET 4.5.2, see Remote Debug ASP.NET on an IIS Computer. Vous pouvez également déployer et déboguer sur IIS à l’aide d’Azure.You can also deploy and debug on IIS using Azure. Pour le Service d’applications Azure, vous pouvez facilement déployer et déboguer sur une instance préconfigurée de IIS et le débogueur distant en utilisant le instantané débogueur 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 and the remote debugger using either the Snapshot Debugger 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 8Windows Server 2012 R2 and IIS 8
  • Windows Server 2016 et IIS 10Windows Server 2016 and IIS 10

SpécificationsRequirements

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. Pour obtenir une liste complète des conditions requises, consultez exigences.For a complete list of requirements, see Requirements.

Créer l’application ASP.NET Core sur l’ordinateur Visual Studio 2017Create the ASP.NET Core application on the Visual Studio 2017 computer

  1. Créez une application ASP.NET Core.Create a new ASP.NET Core application. (Fichier > Nouveau > projet, puis sélectionnez Visual c# > Web > Application ASP.NET Core Web).(File > New > Project, then select Visual C# > Web > ASP.NET Core Web Application).

    Dans le ASP.NET Core section modèles, sélectionnez Application Web.In the ASP.NET Core templates section, select Web Application.

  2. Assurez-vous que ASP.NET Core 2.0 est sélectionnée, qui activer la prise en charge Docker est pas sélectionné et que authentification a la valeur Aucune authentification.Make sure that ASP.NET Core 2.0 is selected, that Enable Docker Support is not selected and that Authentication is set to No Authentication.

  3. Nommez le projet MyASPApp et cliquez sur OK pour créer la nouvelle solution.Name the project MyASPApp and click OK to create the new solution.

  4. Ouvrez le fichier About.cshtml.cs et définir un point d’arrêt dans le OnGet (méthode) (dans les modèles plus anciens, ouvrez plutôt HomeController.cs et définissez le point d’arrêt le About() méthode).Open the About.cshtml.cs file and set a breakpoint in the OnGet method (in older templates, open HomeController.cs instead and set the 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 Core sur Windows ServerInstall ASP.NET Core on Windows Server

  1. Installer le hébergement sur serveur Windows .NET Core offre groupée sur le système hôte.Install the .NET Core Windows Server Hosting bundle on the hosting system. L’application installe le .NET Core Runtime, bibliothèque principale de .NET et le Module de base ASP.NET.The bundle installs the .NET Core Runtime, .NET Core Library, and the ASP.NET Core Module. Pour obtenir des instructions plus détaillées, consultez publication sur IIS.For more in-depth instructions, see Publishing to IIS.

    Note

    Si le système ne dispose d’une connexion Internet, obtenez et installez le redistribuable Microsoft Visual C++ 2015 avant d’installer l’application d’hébergement sur serveur Windows .NET Core.If the system doesn't have an Internet connection, obtain and install the Microsoft Visual C++ 2015 Redistributable before installing the .NET Core Windows Server Hosting bundle.

  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 aucun Code managé.Open DefaultAppPool and set the Application pool field to No Managed Code.

  8. Cliquez sur le nouveau site dans le Gestionnaire des services Internet, choisissez modifier les autorisationset assurez-vous que IUSR, IIS_IUSRS ou l’utilisateur configuré pour l’accès à l’application web est un utilisateur autorisé avec des droits de lecture et exécution.Right-click the new site in the IIS Manager, choose Edit Permissions, and make sure that IUSR, IIS_IUSRS, or the user configured for access to the web app is an authorized user with Read & Execute rights.

    Si vous ne voyez pas un de ces utilisateurs avec accès, suivez les étapes pour ajouter IUSR en tant qu’utilisateur avec des droits de lecture et exécution.If you don't see one of these users with access, go through steps to 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.

(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. 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

  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.

    Si vous souhaitez utiliser le trouver bouton, vous devrez peut-être ouvrir le port UDP 3702 sur le serveur.If you want to use the Find button, you may need to open UDP port 3702 on the server.

  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 dotnet.exe (pour ASP.NET Core).Type the first letter of a process name to quickly find dotnet.exe (for ASP.NET Core).

    RemoteDBG_AttachToProcessRemoteDBG_AttachToProcess

  7. Cliquez sur Attacher.Click 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
  • 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.
  • 8172 - (facultatif) requis pour Web Deploy déployer l’application à partir de Visual Studio.8172 - (Optional) Required for Web Deploy to deploy the app from Visual Studio.
  • 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, puis cliquez sur suivant.Then choose Inbound Rules > New Rule > Port, and then click Next. (Pour UDP 3702, choisissez règles de trafic sortant à la place.)(For UDP 3702, choose Outbound Rules instead.)

  3. Sous ports locaux spécifiques, entrez le numéro de port, cliquez sur suivant.Under Specific local ports, enter the port number, click Next.

  4. Cliquez sur autoriser la connexion, cliquez sur suivant.Click Allow the Connection, click Next.

  5. Sélectionnez un ou plusieurs types de réseau à activer pour le port, puis cliquez sur suivant.Select one or more network types to enable for the port and click Next.

    Les types que vous sélectionnez doivent inclure le réseau auquel l’ordinateur distant est connecté.The type you select must include the network to which the remote computer is connected.

  6. Ajoutez le nom (par exemple, IIS, Web Deploy, ou msvsmon) pour la règle de trafic entrant et cliquez sur Terminer.Add the name (for example, IIS, Web Deploy, or msvsmon) for the Inbound Rule and click Finish.

    Vous devez voir votre nouvelle règle dans la liste des règles de trafic entrant et les règles de trafic sortant.You should see your new rule in the Inbound Rules or Outbound Rules list.

    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.

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