Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ce document explique comment attacher le débogueur distant Visual Studio aux processus d'une VM Compute Engine exécutant Windows.
Prérequis
Avant de commencer, assurez-vous que votre VM respecte les prérequis suivants :
Elle exécute le système d'exploitation Windows.
Elle dispose d'une adresse IP publique.
La session PowerShell distante est installée et activée.
Si vous ne souhaitez pas activer la connexion à distance PowerShell ou si elle n'est pas installée sur la VM, vous pouvez trouver les étapes à suivre pour installer manuellement les outils à distance du débogueur Visual Studio en recherchant débogage à distance MSDN Visual Studio.
Sélectionnez Tools > Google Cloud Tools > Show Google Cloud Explorer (Outils > Outils Google Cloud > Afficher Google Cloud Explorer) pour lancer Cloud Explorer.
Cliquez avec le bouton droit de la souris sur l'instance de VM Compute Engine à laquelle vous souhaitez attacher le débogueur distant, puis sélectionnez Attach debugger (Attacher le débogueur).
L'assistant d'attache du débogueur s'affiche.
Cliquez sur OK lorsque vous y êtes invité pour ajouter des règles de pare-feu afin d'autoriser le trafic vers les ports requis.
Le lien Learn more (En savoir plus) dans la boîte de dialogue vous permet d'accéder à la section Ouvrir les ports de pare-feu pour plus d'informations.
Sélectionnez le processus à déboguer et cliquez sur OK.
Veuillez noter les points suivants :
La première fois que vous vous connectez à une instance de VM distante, l'assistant installe les outils à distance du débogueur Visual Studio à votre place. Cette installation peut prendre un certain temps si la VM se trouve dans une région différente.
Les outils de débogage sont installés dans le répertoire Program Files\VisualStudioRemoteTools de la machine cible.
Vous devez charger manuellement les symboles si vous souhaitez optimiser votre version :
Lors du débogage de votre application, sélectionnez Debug > Windows > Modules (Débogage > Windows > Modules).
Localisez votre assemblage de débogage.
Cliquez avec le bouton droit sur l'entrée appropriée et sélectionnez Load Symbols (Charger les symboles).
Ouvrir les ports de pare-feu
Pour activer le débogage distant, vous devez ajouter des règles de pare-feu pour autoriser le trafic sur la machine cible et permettre la connexion aux outils de débogage distant. Pour Visual Studio 2017, le port est 4022.
Cloud Tools for Visual Studio peut installer et démarrer des outils à distance à l'aide d'une connexion PowerShell distante. Vous devez au préalable activer le port 5986 afin d'autoriser HTTPs pour PowerShell distant.
Lorsque vous avez terminé le débogage, supprimez les règles de pare-feu :
Sélectionnez Tools > Google Cloud Tools > Show Google Cloud Explorer (Outils > Outils Google Cloud > Afficher Google Cloud Explorer) pour lancer Cloud Explorer.
Cliquez avec le bouton droit sur l'instance de VM Compute Engine et sélectionnez Firewall Options... (Options de pare-feu).
Désactivez les cases à cocher pour les règles de pare-feu Allow Visual Studio Debugger connections to the instance (Autoriser les connexions du débogueur Visual Studio à l'instance) et Allow Remote PowerShell HTTPs traffic to the instance (Autoriser le trafic HTTPs PowerShell distant vers l'instance).
Cliquez sur Save (Enregistrer) pour supprimer les règles de pare-feu.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[],[],null,["# Attaching the remote debugger\n\n| **Beta**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nThis document describes how to attach the Visual Studio remote debugger to\nprocesses on a Compute Engine Virtual Machine running Windows.\n\nPrerequisites\n-------------\n\nBefore you begin, ensure your virtual machine meets the following prerequisites:\n\n- Running the Windows operating system\n\n- Has a public IP address\n\n- Has Remote PowerShell installed and enabled\n\n - If you don't want to enable Remote PowerShell connection, or if it's not\n installed on the VM, you can find steps to install the Visual Studio\n Debugger Remote Tools manually by searching for **MSDN Visual Studio\n Remote Debugging**.\n\n - You can also [add firewall rules](/compute/docs/vpc/using-firewalls)\n to unblock the Debugger Remote Tool port.\n\nYou can [deploy an ASP.NET framework image](https://console.cloud.google.com/marketplace/details/click-to-deploy-images/aspnet?_ga=1.196962543.236660576.1482928062)\nthat meets all of these prerequisites.\n\nAttaching the remote debugger\n-----------------------------\n\nTo attach the remote debugger:\n\n1. Select **Tools** \\\u003e **Google Cloud Tools** \\\u003e **Show Google Cloud Explorer** to\n launch the **Cloud Explorer**.\n\n2. Right click the Compute Engine VM instance you want to attach the\n remote debugger to and select **Attach debugger**.\n\n The attach debugger wizard displays.\n3. Click **OK** when prompted to add firewall rules to allow traffic to the\n required ports.\n\n 1. The **Learn more** link in the dialog takes you to the [Opening firewall ports](#open_firewall_port) section for more information.\n4. Select the process to debug and click **OK**.\n\nNote the following:\n\n- The first time you connect to a remote VM instance, the wizard installs Visual\n Studio Debugger Remote Tools for you. This installation can take some time if\n the VM is in a different region.\n\n- The debugger tools are installed in `Program Files\\VisualStudioRemoteTools` on\n the target machine.\n\n- You must load symbols manually if you optimize your release build:\n\n 1. As you are debugging your application, select **Debug** \\\u003e **Windows** \\\u003e\n **Modules**.\n\n 2. Locate your debuggee assembly.\n\n 3. Right click the appropriate entry and select **Load Symbols**.\n\n### Opening firewall ports\n\nTo enable remote debugging, you need to add firewall rules to allow traffic to\nthe target machine and enable connection to the Debugging Remote Tools. For\nVisual Studio 2017, the port is **4022**.\n\nCloud Tools for Visual Studio can install and start remote tools for you using a\nremote PowerShell connection. You first must enable remote PowerShell HTTPs port\n**5986**.\n\nWhen you are finished debugging, remove the firewall rules:\n\n1. Select **Tools** \\\u003e **Google Cloud Tools** \\\u003e **Show Google Cloud Explorer** to\n launch the **Cloud Explorer**.\n\n2. Right click the Compute Engine VM instance and select\n **Firewall Options...**.\n\n3. Clear the checkboxes for the **Allow Visual Studio Debugger connections to\n the instance** and the **Allow Remote PowerShell HTTPs traffic to the\n instance** firewall rules.\n\n4. Click **Save** to remove the firewall rules."]]
