Débogage distant ASP.NET Core sur un ordinateur distant IIS 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 attacher à 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 paramétrer et configurer un noyau ASP.NET de Visual Studio 2017, 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 débogage distant de ASP.NET 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 Azure App Service, vous pouvez facilement déployer et déboguer sur une instance préconfigurée d’IIS et le débogueur distant en utilisant soit le débogueur de capture instantanée 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

Configuration requiseRequirements

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 faible bande passante, telles que la numérotation Internet, ou via Internet entre les 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 exigences, consultez exigences.For a complete list of requirements, see Requirements.

Application déjà en cours d’exécution dans IIS ?App already running in IIS?

Cet article contient des instructions sur la configuration d’une configuration de base d’IIS sur Windows server et le déploiement de l’application à partir de Visual Studio.This article includes steps on setting up a basic configuration of IIS on Windows server and deploying the app from Visual Studio. Ces étapes sont inclus pour vous assurer que le serveur a exigé des composants installés, que l’application peut s’exécuter correctement et que vous êtes prêt à déboguer à distance.These steps are included to make sure that the server has required components installed, that the app can run correctly, and that you are ready to remote debug.

  • Si votre application s’exécute dans IIS et que vous souhaitez simplement télécharger le débogueur distant et démarrer le débogage, accédez à télécharger et installer les outils à distance sur Windows Server.If your app is running in IIS and you just want to download the remote debugger and start debugging, go to Download and Install the remote tools on Windows Server.

  • Si vous souhaitez une aide pour vous assurer que votre application est configurée, déployé et fonctionne correctement dans IIS afin que vous puissiez déboguer, suivez les étapes dans cette rubrique.If you want help to make sure that your app is set up, deployed, and running correctly in IIS so that you can debug, follow all the steps in this topic.

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 nouvelle application ASP.NET Core.Create a new ASP.NET Core application. (Fichier > Nouveau > projet, puis sélectionnez Visual c# > Web > Application Web ASP.NET Core).(File > New > Project, then select Visual C# > Web > ASP.NET Core Web Application).

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

  2. Assurez-vous que l’option ASP.NET Core 2.0 est sélectionnée, qui activer la prise en charge Docker est pas sélectionné et que authentification est défini sur 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 solution.Name the project MyASPApp and click OK to create the new solution.

  4. Ouvrez le fichier About.cshtml.cs et définissez un point d’arrêt dans le OnGet (méthode) (dans les modèles plus anciens, open Homecontrôleur.cs au lieu de cela et définir le point d’arrêt dans 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 de 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 Server, utilisez le Ajout de rôles et fonctionnalités Assistant via la gérer lien ou le tableau de bord lier 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. Si vous souhaitez activer le déploiement à l’aide de paramètres de publication et Web Deploy, assurez-vous que gestion des Scripts et outils IIS est sélectionné.If you want to enable deployment using publish settings and Web Deploy, make sure that IIS Management Scripts and Tools is selected.

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

Si la Configuration de sécurité renforcée est activée dans Internet Explorer (il est activé par défaut), vous devrez peut-être ajouter des domaines comme sites approuvés pour vous permettre de télécharger certaines des composants de serveur web.If Enhanced Security Configuration is enabled in Internet Explorer (it is enabled by default), then you may need to add some domains as trusted sites to enable you to download some of the web server components. Ajouter les sites de confiance en accédant à Options Internet > sécurité > Sites de confiance > Sites.Add the trusted sites by going to Internet Options > Security > Trusted Sites > Sites. Ajoutez les domaines suivants.Add the following domains.

  • Microsoft.commicrosoft.com
  • go.microsoft.comgo.microsoft.com
  • download.microsoft.comdownload.microsoft.com
  • IIS.NETiis.net

Lorsque vous téléchargez le logiciel, vous pouvez obtenir des demandes pour accorder des autorisations requises pour charger des 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. Certaines de ces ressources ne sont pas nécessaires, mais pour simplifier le processus, cliquez sur ajouter lorsque vous y êtes invité.Some of these resources are not required, but to simplify the process, click Add when prompted.

Installer ASP.NET Core sur Windows ServerInstall ASP.NET Core on Windows Server

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

    Note

    Si le système n’a pas une connexion Internet, obtenez et installez le redistribuable Microsoft Visual C++ 2015 avant d’installer le bundle d’hébergement de .NET Core Windows Server.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émarrez le système (ou exécutez net stop was /y suivie net démarrer w3svc à partir d’une invite de commandes à assimiler à une modification apportée à la variable système PATH).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).

Choisissez une option de déploiementChoose a deployment option

Si vous avez besoin vous aide à déployer l’application sur IIS, considérez ces options :If you need help to deploy the app to IIS, consider these options:

  • Déployer en créant un fichier de paramètres de publication dans IIS et de l’importation des paramètres dans Visual Studio.Deploy by creating a publish settings file in IIS and importing the settings in Visual Studio. Dans certains scénarios, il s’agit d’un moyen rapide pour déployer votre application.In some scenarios, this is a fast way to deploy your app. Lorsque vous créez le fichier de paramètres de publication, les autorisations sont automatiquement configurées dans IIS.When you create the publish settings file, permissions are automatically set up in IIS.

  • Déployer en publiant vers un dossier local et la copie de la sortie par une méthode conseillée pour un dossier application préparée sur IIS.Deploy by publishing to a local folder and copying the output by a preferred method to a prepared app folder on IIS.

(Facultatif) Déployer à l’aide d’un fichier de paramètres de publication(Optional) Deploy using a publish settings file

Vous pouvez utiliser cette option créer un fichier de paramètres de publication et l’importer dans Visual Studio.You can use this option create a publish settings file and import it into Visual Studio.

Note

Cette méthode de déploiement utilise Web Deploy.This deployment method uses Web Deploy. Si vous souhaitez configurer Web Deploy manuellement dans Visual Studio au lieu d’importer les paramètres, vous pouvez installer Web déployer 3.6 au lieu de 3.6 de déploiement Web pour les serveurs d’hébergement.If you want to configure Web Deploy manually in Visual Studio instead of importing the settings, you can install Web Deploy 3.6 instead of Web Deploy 3.6 for Hosting Servers. Toutefois, si vous configurez Web Deploy manuellement, vous devez vous assurer qu’un dossier d’application sur le serveur est configuré avec les valeurs correctes et les autorisations (voir site Web de ASP.NET configurer).However, if you configure Web Deploy manually, you will need to make sure that an app folder on the server is configured with the correct values and permissions (see Configure ASP.NET Web site).

Installer et configurer Web Deploy pour les serveurs d’hébergement sur Windows ServerInstall and configure Web Deploy for Hosting Servers on Windows Server

Web Deploy 3.6 pour les serveurs d’hébergement fournit les fonctionnalités de configuration supplémentaires qui permettent la création du fichier de paramètres de publication à partir de l’interface utilisateur.Web Deploy 3.6 for Hosting Servers provides additional configuration features that enable the creation of the publish settings file from the UI.

  1. Si vous avez Web déployer 3.6 est déjà installé sur Windows Server, désinstallez-le à l’aide de le panneau de configuration > programmes > désinstaller un programme.If you have Web Deploy 3.6 already installed on Windows Server, uninstall it using Control Panel > Programs > Uninstall a Program.

  2. Ensuite, installez 3.6 de déploiement Web pour les serveurs d’hébergement sur Windows Server.Next, install Web Deploy 3.6 for Hosting Servers on Windows Server.

    Pour installer Web Deploy pour les serveurs d’hébergement, utilisez le Web Platform Installer (WebPI).To install Web Deploy for Hosting Servers, use the Web Platform Installer (WebPI). (Pour rechercher le lien de Web Platform Installer à partir d’IIS, sélectionnez IIS dans le volet gauche du Gestionnaire de serveur.(To find the Web Platform Installer link from IIS, select IIS in the left pane of Server Manager. Cliquez sur le serveur et sélectionnez Internet Information Services (IIS) Manager.)Right-click the server and select Internet Information Services (IIS) Manager.)

    Dans le programme Web Platform Installer, vous recherchez Web Deploy pour les serveurs d’hébergement sous l’onglet Applications.In the Web Platform Installer, you find Web Deploy for Hosting Servers in the Applications tab.

  3. Si vous avez déjà installé gestion des Scripts et outils IIS, installez-le maintenant.If you did not already install IIS Management Scripts and Tools, install it now.

    Accédez à sélectionner des rôles de serveur > serveur Web (IIS) > outils de gestion, puis sélectionnez le des Scripts de gestion IIS Outils et rôle, cliquez sur suivant, puis installer le rôle.Go to Select server roles > Web Server (IIS) > Management Tools, and then select the IIS Management Scripts and Tools role, click Next, and then install the role.

    Installer les outils et les Scripts de gestion IIS

    Les scripts et les outils sont requis pour activer la génération du fichier de paramètres de publication.The scripts and tools are required to enable the generation of the publish settings file.

  4. (Facultatif) 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 l’option Service de l’Agent de déploiement Web est en cours d’exécution (le nom du service est différent dans les versions antérieures).(Optional) 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.

Créer le fichier de paramètres de publication dans IIS sur Windows ServerCreate the publish settings file in IIS on Windows Server

  1. Fermez et rouvrez la Console de gestion IIS pour afficher les options de configuration mis à jour dans l’interface utilisateur.Close and reopen the IIS Management Console to show updated configuration options in the UI.

  2. Dans IIS, cliquez sur le Site Web par défaut, choisissez déployer > configurer Web déployer la publication.In IIS, right-click the Default Web Site, choose Deploy > Configure Web Deploy Publishing.

    Configurer Web Deploy

  3. Dans le configurer Web déployer la publication boîte de dialogue zone, examinez les paramètres.In the Configure Web Deploy Publishing dialog box, examine the settings.

  4. Cliquez sur le programme d’installation.Click Setup.

    Dans le résultats Panneau de configuration, la sortie montre que les droits d’accès est accordée à l’utilisateur spécifié et qu’un fichier avec un .publishsettings extension de fichier a été générée à l’emplacement indiqué dans la boîte de dialogue zone.In the Results panel, the output shows that access rights are granted to the specified user, and that a file with a .publishsettings file extension has been generated in the location shown in the dialog box.

    <?xml version="1.0" encoding="utf-8"?>
    <publishData>
      <publishProfile
        publishUrl="https://myhostname:8172/msdeploy.axd"
        msdeploySite="Default Web Site"
        destinationAppUrl="http://myhostname:80/"
        mySQLDBConnectionString=""
        SQLServerDBConnectionString=""
        profileName="Default Settings"
        publishMethod="MSDeploy"
        userName="myhostname\myusername" />
    </publishData>
    

    Selon votre configuration de Windows Server et IIS, vous consultez des valeurs différentes dans le fichier XML.Depending on your Windows Server and IIS configuration, you see different values in the XML file. Voici quelques détails sur les valeurs que vous voyez :Here are a few details about the values that you see:

    • Le msdeploy.axd fichier référencé dans le publishUrl attribut est un fichier de gestionnaire HTTP généré dynamiquement pour Web Deploy.The msdeploy.axd file referenced in the publishUrl attribute is a dynamically generated HTTP handler file for Web Deploy. (Pour des tests, http://myhostname:8172 généralement fonctionne aussi bien.)(For testing purposes, http://myhostname:8172 generally works as well.)
    • Le publishUrl port est défini sur le port 8172, qui est la valeur par défaut pour Web Deploy.The publishUrl port is set to port 8172, which is the default for Web Deploy.
    • Le destinationAppUrl port est défini sur le port 80, qui est la valeur par défaut pour IIS.The destinationAppUrl port is set to port 80, which is the default for IIS.
    • Si vous ne parvenez pas à vous connecter à l’hôte distant dans Visual Studio en utilisant le nom d’hôte (dans les étapes ultérieures), testez l’adresse IP à la place le nom d’hôte.If you are unable to connect to the remote host in Visual Studio using the host name (in later steps), test the IP address in place of the host name.

      Note

      Si vous publiez sur IIS s’exécutant sur une machine virtuelle Azure, vous devez ouvrir les ports IIS et Web Deploy dans le groupe de sécurité réseau.If you are publishing to IIS running on an Azure VM, you must open the Web Deploy and IIS ports in the Network Security group. Pour plus d’informations, consultez installer et exécuter IIS.For detailed information, see Install and run IIS.

  5. Copiez ce fichier sur l’ordinateur où vous exécutez Visual Studio.Copy this file to the computer where you are running Visual Studio.

Importer les paramètres de publication dans Visual Studio et déployerImport the publish settings in Visual Studio and deploy

  1. Sur l’ordinateur où vous avez le projet ASP.NET ouvert dans Visual Studio, cliquez sur le projet dans l’Explorateur de solutions, puis choisissez publier.On the computer where you have the ASP.NET project open in Visual Studio, right-click the project in Solution Explorer, and choose Publish.

  2. Si vous avez déjà configuré des profils de publication, le publier volet s’affiche.If you have previously configured any publishing profiles, the Publish pane appears. Cliquez sur créer nouveau profil.Click Create new profile.

  3. Dans le choisir une cible de publication boîte de dialogue, cliquez sur importer un profil.In the Pick a publish target dialog box, click Import Profile.

    Choisissez publier

  4. Accédez à l’emplacement du fichier de paramètres de publication que vous avez créé dans la section précédente.Navigate to the location of the publish settings file that you created in the previous section.

  5. Dans le importation publier un fichier de paramètres boîte de dialogue, accédez à et sélectionnez le profil que vous avez créé dans la section précédente, puis cliquez sur Open.In the Import Publish Settings File dialog box, navigate to and select the profile that you created in the previous section, and click Open.

    Visual Studio lance le processus de déploiement, et la fenêtre Sortie affiche la progression et les résultats.Visual Studio begins the deployment process, and the Output window shows progress and results.

    Si vous obtenez des erreurs de tout un déploiement, cliquez sur paramètres pour modifier les paramètres.If you get an any deployment errors, click Settings to edit settings. Modifier les paramètres et cliquez sur Validate pour tester les nouveaux paramètres.Modify settings and click Validate to test new settings. Si le nom d’hôte est introuvable, essayez de l’adresse IP au lieu du nom d’hôte dans le Server et URL de Destination champs.If the host name is not found, try the IP address instead of the host name in the Server and Destination URL fields.

    Modifier les paramètres dans l’outil de publication

Une fois que l’application se déploie correctement, il doit démarrer automatiquement.After the app deploys successfully, it should start automatically. Si l’application ne démarre pas à partir de Visual Studio, démarrez l’application dans IIS.If the app does not start from Visual Studio, start the app in IIS. Pour ASP.NET Core, vous devez vous assurer que le pool d’applications de champ pour le DefaultAppPool a la valeur aucun Code managé.For ASP.NET Core, you need to make sure that the Application pool field for the DefaultAppPool is set to No Managed Code.

  1. Dans le paramètres boîte de dialogue, activer le débogage en cliquant sur suivant, choisissez un déboguer configuration, puis choisissez supprimer les fichiers supplémentaires à destination sous le de publication des fichiers options.In the Settings dialog box, enable debugging by clicking Next, choose a Debug configuration, and then 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 web.config lors de la publication de fichiers.If you choose a Release configuration, you disable debugging in the web.config file when you publish.

  2. Cliquez sur enregistrer avant de republier l’application.Click Save and then republish the app.

(Facultatif) Déployer en le publiant sur un dossier local(Optional) Deploy by publishing to a local folder

Vous pouvez utiliser cette option pour déployer votre application si vous souhaitez copier l’application IIS à l’aide de Powershell, RoboCopy, ou que vous souhaitez copier manuellement les fichiers.You can use this option to deploy your app if you want to copy the app to IIS using Powershell, RoboCopy, or you want to manually copy the files.

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

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

  2. Si elle n’est pas déjà ouverte, ouvrez le Internet Information Services (IIS) Manager.If it's not already open, 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 Internet Information Services (IIS) Manager.)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 paramètres de baseet définissez le 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 champ MyASPApp, acceptez la valeur par défaut du Pool d’applications (DefaultAppPool) et définissez le 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 définissez le champ pool d’applications sur aucun Code managé.Open DefaultAppPool and set the Application pool field to No Managed Code.

  8. Cliquez sur le nouveau site dans le Gestionnaire IIS, 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 disposant de 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.

Publier et déployer l’application en publiant vers un dossier local à partir de Visual StudioPublish and Deploy the app by publishing to a local folder from Visual Studio

Vous pouvez également publier et déployer l’application avec le 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 les formulaires Web, publier une application de Web).In the Solution Explorer, right-click the project node and select Publish (for Web Forms, Publish Web App).

    Si vous avez déjà configuré des profils de publication, le publier volet s’affiche.If you have previously configured any publishing profiles, the Publish pane appears. Cliquez sur nouveau profil.Click New profile.

  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 créer un profil dans la liste déroulante (publier est la valeur par défaut).Click Create profile in the drop-down list (Publish is the default value).

  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. Définissez la configuration sur 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. Progression s’affiche dans la fenêtre Sortie.Progress shows in the Output window.

  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.

    Caution

    Si vous avez besoin apporter des modifications au code ou de la reconstruction, 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 tentez 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 existe peut-être une incompatibilité entre la version d’ASP.NET installés sur votre serveur et votre ordinateur Visual Studio, ou vous pouvez avoir un problème avec votre configuration IIS ou un 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 machine que vous souhaitez déboguer (plutôt que l’ordinateur qui exécute 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 (version la plus récente)Visual Studio 2017 (latest version) Outils à distanceRemote tools La dernière version des outils à distance est compatible avec toutes les versions de Visual Studio 2017.The latest version of the remote tools is compatible with all Visual Studio 2017 releases. Téléchargez toujours la version correspondant à votre système d’exploitation (x 86, x64 ou ARM64).Always download the version matching your device operating system (x86, x64, or ARM64). Sur Windows Server, consultez débloquer le téléchargement du fichier pour l’aide pour télécharger les outils à distance.On Windows Server, see Unblock the file download for help to download the remote tools.
    Visual Studio 2015Visual Studio 2015 Outils à distanceRemote tools Les outils à distance pour Visual Studio 2015 sont disponibles à partir de My.VisualStudio.com.Remote tools for Visual Studio 2015 are available from My.VisualStudio.com. Si vous y êtes invité, participez à la version gratuite Visual Studio Dev Essentials programme, ou connectez-vous avec votre ID d’abonnement Visual Studio.If prompted, join the free Visual Studio Dev Essentials program, or sign in with your Visual Studio subscription ID. Sur Windows Server, consultez débloquer le téléchargement du fichier pour l’aide pour télécharger les outils à distance.On Windows Server, see Unblock the file download for help to download the remote tools.
    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 (x86, x64, ARM ou ARM64) et téléchargez les outils à distance.On the download page, choose the version of the tools that matches your operating system (x86, x64, ARM, or ARM64) and download the remote tools.

    Important

    Nous vous recommandons d’installer la version la plus récente des outils à distance pour votre version de Visual Studio.We recommend that you install the most recent version of the remote tools for your release of Visual Studio. La version la plus récente (par exemple, 15.8) est compatible avec les versions antérieures (par exemple, 15.0) ; Toutefois, les versions antérieures ne sont pas compatibles avec les versions ultérieures.The latest version (for example, 15.8) is compatible with earlier releases (for example, 15.0); however, earlier versions are not compatible with later releases. 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.

    Pour le débogage sur Windows 10 sur les appareils ARM, cliquez sur Télécharger ARM64 disponible avec la dernière version des outils à distance.For debugging on Windows 10 on ARM devices, choose the ARM64 download available with the latest version of the remote tools. Pour les appareils Windows RT, choisissez la version ARM, qui est uniquement disponible dans le téléchargement de Visual Studio 2015 RTW.For Windows RT devices, choose the ARM version, which is only available 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 tentez de copier le débogueur distant (msvsmon.exe) sur l’ordinateur distant et l’exécuter, n’oubliez pas que le Assistant Configuration Remote Debugger (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.

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. (Recherchez msvsmon.exe dans 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 avec le bouton droit de l’application 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, seulement 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 l’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 de 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 il doit correspondre à la configuration que vous utilisez plus tard 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 vous devez arrêter le débogueur distant, cliquez sur fichier > sortie 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 débogueur distant >\< x86, x64, ARM, ARM64 ou Appx > \msvsmon.exe.<Remote debugger installation directory>\<x86, x64, ARM, ARM64, or Appx>\msvsmon.exe.

Note

Si vous avez besoin pour ajouter des autorisations pour les utilisateurs supplémentaires, modifiez le mode d’authentification, ou le 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 la solution que vous essayez de déboguer (MyASPApp si vous suivez les étapes de cet article).On the Visual Studio computer, open the solution that you are trying to debug (MyASPApp if you are following all the steps in this article).
  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).

    Tip

    Dans Visual Studio 2017, vous pouvez rattacher vers le même processus que vous avez précédemment attaché à l’aide de Déboguer > Attacher au processus... (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 trouver 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 - requises pour IIS80 - Required for IIS
  • 4022 - requis pour le débogage distant à partir de Visual Studio 2017 (consultez Remote Debugger Port Assignments pour plus d’informations.4022 - Required for remote debugging from Visual Studio 2017 (see Remote Debugger Port Assignments for detailed information.
  • 8172 - (facultatif) nécessaire pour Web Deploy pour 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 au 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 ou 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 des pare-feu de 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 nécessaires.Create additional rules for the other required ports.