Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Neste documento, descrevemos como anexar o depurador remoto do Visual Studio aos processos em uma máquina virtual do Google Cloud Compute Engine com Windows.
Pré-requisitos
Antes de começar, confirme se a sua máquina virtual atende aos seguintes pré-requisitos:
tem o sistema operacional Windows
tem um endereço IP público
o Remote PowerShell está instalado e ativado
Se você não quiser ativar a conexão com o Remote PowerShell, ou se ele não estiver instalado na VM, encontre as etapas para instalar as Ferramentas remotas do Depurador do Visual Studio manualmente procurando a Depuração remota do Visual Studio MSDN.
Selecione Ferramentas > Google Cloud Tools > Mostrar o Google Cloud Explorer para iniciar o Cloud Explorer.
Clique com o botão direito do mouse na instância da VM do Compute Engine em que você queira anexar o depurador remoto e selecione Anexar depurador.
O assistente para anexar o depurador é exibido.
Clique em OK quando solicitado a adicionar regras de firewall para permitir o tráfego para as portas necessárias.
O link Saiba mais na caixa de diálogo leva você à seção Como abrir portas de firewall. Lá, você encontrará mais informações.
Selecione o processo a ser depurado e clique em OK.
Observe o seguinte:
Na primeira vez que você se conecta a uma instância de VM remota, o assistente instala as Ferramentas remotas do Depurador do Visual Studio para você. Essa instalação pode levar algum tempo se a VM estiver em uma região diferente.
As ferramentas do depurador são instaladas em Program Files\VisualStudioRemoteTools na máquina de destino.
Para otimizar sua versão de lançamento, é preciso carregar símbolos manualmente:
Como você está depurando seu aplicativo, selecione Depurar > Windows > Módulos.
Localize seu conjunto depurado.
Clique com o botão direito do mouse na entrada apropriada e selecione Carregar símbolos.
Como abrir portas de firewall
Para ativar a depuração remota, você precisa adicionar regras de firewall para permitir o tráfego à máquina de destino e ativar a conexão com as ferramentas remotas de depuração. Para o Visual Studio 2017, a porta é 4022.
O Cloud Tools for Visual Studio instala e inicia ferramentas remotas para você usando uma conexão remota do PowerShell. Primeiro, você precisa ativar a porta HTTPs do PowerShell remoto
5986.
Quando terminar a depuração, remova as regras de firewall:
Selecione Ferramentas > Google Cloud Tools > Mostrar o Google Cloud Explorer para iniciar o Cloud Explorer.
Clique com o botão direito do mouse na instância de VM do Compute Engine e selecione Opções de firewall...
Desmarque as caixas de seleção das regras de firewall Permitir conexões do depurador do Visual Studio com a instância e Permitir tráfego HTTPs do PowerShell remoto para a instância.
Clique em Salvar para remover as regras do firewall.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-01 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."]]
