Depuração remotaRemote Debugging

Você pode depurar um aplicativo do Visual Studio que foi implantado em um computador diferente.You can debug a Visual Studio application that has been deployed on a different computer. Para fazer isso, use o depurador remoto do Visual Studio.To do so, you use the Visual Studio remote debugger.

Para obter instruções detalhadas sobre a depuração remota, consulte estes tópicos.For in-depth instructions on remote debugging, see these topics.

CenárioScenario LinkLink
Serviço de aplicativo do AzureAzure App Service Depuração remota ASP.net no Azure ou, por Visual Studio Enterprise, o depurador de instantâneosRemote debug ASP.NET on Azure or, for Visual Studio Enterprise, the Snapshot Debugger
VM do AzureAzure VM Depuração remota ASP.NET no AzureRemote debug ASP.NET on Azure
Azure Service FabricAzure Service Fabric Depurar um aplicativo de Service Fabric do AzureDebug an Azure Service Fabric application
ASP.NETASP.NET ASP.NET Core de depuração remota ou depuração remota ASP.netRemote debug ASP.NET Core or Remote Debug ASP.NET
C# ou Visual BasicC# or Visual Basic Depuração remota de um projeto C# ou Visual BasicRemote debug a C# or Visual Basic project
C++C++ Depuração remota de um projeto C++Remote debug a C++ project
Aplicativos universais do Windows (UWP)Universal Windows Apps (UWP) Executar aplicativos UWP em um computador remoto ou depurar um pacote do aplicativo instaladoRun UWP apps on a remote machine or Debug an installed app package

Se você quiser apenas baixar e instalar o depurador remoto e não precisar de instruções adicionais para seu cenário, siga as etapas neste artigo.If you just want to download and install the remote debugger and don't need any additional instructions for your scenario, follow the steps in this article.

Baixar e instalar as ferramentas remotasDownload and Install the remote tools

No dispositivo ou servidor remoto no qual você deseja depurar, em vez de no computador do Visual Studio, baixe e instale a versão correta das ferramentas remotas nos links na tabela a seguir.On the remote device or server that you want to debug on, rather than the Visual Studio machine, download and install the correct version of the remote tools from the links in the following table.

  • Baixe as ferramentas remotas mais recentes para sua versão do Visual Studio.Download the most recent remote tools for your version of Visual Studio. A versão mais recente das ferramentas remotas é compatível com versões anteriores do Visual Studio, mas versões anteriores das ferramentas remotas não são compatíveis com as versões posteriores do Visual Studio.The latest remote tools version is compatible with earlier Visual Studio versions, but earlier remote tools versions aren't compatible with later Visual Studio versions. (Por exemplo, se você estiver usando o Visual Studio 2017, baixe a atualização mais recente das ferramentas remotas para o Visual Studio 2017.(For example, if you are using Visual Studio 2017, download the latest update of the remote tools for Visual Studio 2017. Nesse cenário, não baixe as ferramentas remotas para o Visual Studio 2019.)In this scenario, do not download the remote tools for Visual Studio 2019.)
  • Baixe as ferramentas remotas com a mesma arquitetura do computador em que você as está instalando.Download the remote tools with the same architecture as the machine you're installing them on. Por exemplo, se você quiser depurar um aplicativo de 32 bits em um computador remoto que executa um sistema operacional de 64 bits, instale as ferramentas remotas de 64 bits.For example, if you want to debug a 32-bit app on a remote computer running a 64-bit operating system, install the 64-bit remote tools.
VersãoVersion LinkLink ObservaçõesNotes
Visual Studio 2019Visual Studio 2019 Ferramentas remotasRemote tools Compatível com todas as versões do Visual Studio 2019.Compatible with all Visual Studio 2019 versions. Baixe a versão correspondente ao sistema operacional do dispositivo (x86, x64 ou ARM64).Download the version matching your device operating system (x86, x64, or ARM64). No Windows Server, consulte desbloquear o download do arquivo para obter ajuda para baixar as ferramentas remotas.On Windows Server, see Unblock the file download for help downloading the remote tools.
Visual Studio 2017Visual Studio 2017 Ferramentas remotasRemote tools Compatível com todas as versões do Visual Studio 2017.Compatible with all Visual Studio 2017 versions. Baixe a versão correspondente ao sistema operacional do dispositivo (x86, x64 ou ARM64).Download the version matching your device operating system (x86, x64, or ARM64). No Windows Server, consulte desbloquear o download do arquivo para obter ajuda para baixar as ferramentas remotas.On Windows Server, see Unblock the file download for help downloading the remote tools.
Visual Studio 2015Visual Studio 2015 Ferramentas remotasRemote tools As ferramentas remotas para Visual Studio 2015 estão disponíveis em My.VisualStudio.com.Remote tools for Visual Studio 2015 are available from My.VisualStudio.com. Se solicitado, ingresse no programa de Visual Studio dev Essentials gratuito ou entre com sua ID de assinatura do Visual Studio.If prompted, join the free Visual Studio Dev Essentials program, or sign in with your Visual Studio subscription ID. No Windows Server, consulte desbloquear o download do arquivo para obter ajuda para baixar as ferramentas remotas.On Windows Server, see Unblock the file download for help downloading the remote tools.
Visual Studio 2013Visual Studio 2013 Ferramentas remotasRemote tools Página de download na documentação do Visual Studio 2013Download page in Visual Studio 2013 documentation
Visual Studio 2012Visual Studio 2012 Ferramentas remotasRemote tools Página de download na documentação do Visual Studio 2012Download page in Visual Studio 2012 documentation
VersãoVersion LinkLink ObservaçõesNotes
Visual Studio 2017Visual Studio 2017 Ferramentas remotasRemote tools Compatível com todas as versões do Visual Studio 2017.Compatible with all Visual Studio 2017 versions. Baixe a versão correspondente ao sistema operacional do dispositivo (x86, x64 ou ARM64).Download the version matching your device operating system (x86, x64, or ARM64). No Windows Server, consulte desbloquear o download do arquivo para obter ajuda para baixar as ferramentas remotas.On Windows Server, see Unblock the file download for help downloading the remote tools. Para obter a versão mais recente das ferramentas remotas, abra o documento do Visual Studio 2019.For the most recent version of the remote tools, open the Visual Studio 2019 doc.
Visual Studio 2015Visual Studio 2015 Ferramentas remotasRemote tools As ferramentas remotas para Visual Studio 2015 estão disponíveis em My.VisualStudio.com.Remote tools for Visual Studio 2015 are available from My.VisualStudio.com. Se solicitado, ingresse no programa de Visual Studio dev Essentials gratuito ou entre com sua ID de assinatura do Visual Studio.If prompted, join the free Visual Studio Dev Essentials program, or sign in with your Visual Studio subscription ID. No Windows Server, consulte desbloquear o download do arquivo para obter ajuda para baixar as ferramentas remotas.On Windows Server, see Unblock the file download for help downloading the remote tools.
Visual Studio 2013Visual Studio 2013 Ferramentas remotasRemote tools Página de download na documentação do Visual Studio 2013Download page in Visual Studio 2013 documentation
Visual Studio 2012Visual Studio 2012 Ferramentas remotasRemote tools Página de download na documentação do Visual Studio 2012Download page in Visual Studio 2012 documentation

Você pode executar o depurador remoto copiando msvsmon.exe para o computador remoto, em vez de instalar as ferramentas remotas.You can run the remote debugger by copying msvsmon.exe to the remote computer, rather than installing the remote tools. No entanto, o assistente de configuração do depurador remoto (rdbgwiz.exe) está disponível somente quando você instala as ferramentas remotas.However, the Remote Debugger Configuration Wizard (rdbgwiz.exe) is available only when you install the remote tools. Talvez seja necessário usar o assistente para configuração se você quiser executar o depurador remoto como um serviço.You may need to use the wizard for configuration if you want to run the remote debugger as a service. Para obter mais informações, consulte (opcional) configurar o depurador remoto como um serviço.For more information, see (Optional) Configure the remote debugger as a service.

Observação

  • Para depurar aplicativos do Windows 10 em dispositivos ARM, use o ARM64, que está disponível com a versão mais recente das ferramentas remotas.To debug Windows 10 apps on ARM devices, use ARM64, which is available with the latest version of the remote tools.
  • Para depurar aplicativos do Windows 10 em dispositivos Windows RT, use o ARM, que está disponível somente no download de ferramentas remotas do Visual Studio 2015.To debug Windows 10 apps on Windows RT devices, use ARM, which is available only in the Visual Studio 2015 remote tools download.

RequisitosRequirements

Sistemas operacionais com suporteSupported Operating Systems

O computador remoto deve estar executando um dos seguintes sistemas operacionais:The remote computer must be running one of the following operating systems:

  • Windows 10 (não telefone)Windows 10 (not phone)

  • Windows 8 ou 8,1 (não telefone)Windows 8 or 8.1 (not phone)

  • Windows 7 Service Pack 1Windows 7 Service Pack 1

  • Windows Server 2016Windows Server 2016

  • Windows Server 2012 R2 ou Windows Server 2012Windows Server 2012 or Windows Server 2012 R2

  • Windows Server 2008 Service Pack 2, Windows Server 2008 R2 Service Pack 1Windows Server 2008 Service Pack 2, Windows Server 2008 R2 Service Pack 1

Observação

Windows Phone requer uma conexão USB para depurar (não requer as ferramentas remotas).Windows Phone requires a USB connection to debug (it does not require the remote tools).

Configurações de hardware com suporteSupported Hardware Configurations

  • Processador de 1,6 GHz ou mais rápido1.6 GHz or faster processor

  • 1 GB de RAM (1,5 GB se executado em uma máquina virtual)1 GB of RAM (1.5 GB if running on a virtual machine)

  • 1 GB de espaço em disco disponível1 GB of available hard disk space

  • Disco rígido de 5400 RPM5400-RPM hard drive

  • Placa de vídeo compatível com DirectX 9 com execução na resolução de tela 1024 x 768 ou superiorDirectX 9-capable video card running at 1024 x 768 or higher display resolution

Configuração de redeNetwork configuration

O computador remoto e o computador do Visual Studio devem estar conectados por uma rede, grupo de trabalho ou grupo doméstico, ou conectados diretamente por meio de um cabo Ethernet.The remote computer and the Visual Studio computer must be connected over a network, workgroup, or homegroup, or else connected directly through an Ethernet cable. Não há suporte para a depuração entre dois computadores conectados por meio de um proxy.Debugging between two computers connected through a proxy is not supported. A depuração em uma conexão de alta latência ou de baixa largura de banda, como a Internet dial-up ou pela Internet entre países, não é recomendada e pode falhar ou ser lenta de forma inaceitável.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.

Adicional Para executar o depurador remoto de um compartilhamento de arquivos(Optional) To run the remote debugger from a file share

Você pode encontrar o depurador remoto (msvsmon.exe) em um computador com Visual Studio Community, Professional ou Enterprise já instalado.You can find the remote debugger (msvsmon.exe) on a computer with Visual Studio Community, Professional, or Enterprise already installed. Para alguns cenários, a maneira mais fácil de configurar a depuração remota é executar o depurador remoto (msvsmon.exe) de um compartilhamento de arquivos.For some scenarios, the easiest way to set up remote debugging is to run the remote debugger (msvsmon.exe) from a file share. Para obter limitações de uso, consulte a página de ajuda do depurador remoto (ajuda > uso no depurador remoto).For usage limitations, see the remote debugger's Help page (Help > Usage in the remote debugger).

  1. Encontre msvsmon.exe no diretório que corresponde à sua versão do Visual Studio:Find msvsmon.exe in the directory matching your version of Visual Studio:

    Arquivos de programas (x86) \Microsoft Visual Studio\2019\Enterprise\Common7\IDE\Remote Debugger\x86\msvsmon.exeProgram Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\Remote Debugger\x86\msvsmon.exe

    Arquivos de programas (x86) \Microsoft Visual Studio\2019\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exeProgram Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exe

    Arquivos de programas (x86) \Microsoft Visual Studio\2017\Enterprise\Common7\IDE\Remote Debugger\x86\msvsmon.exeProgram Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\Remote Debugger\x86\msvsmon.exe

    Arquivos de programas (x86) \Microsoft Visual Studio\2017\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exeProgram Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exe

  2. Compartilhe a pasta do depurador remoto no computador do Visual Studio.Share the Remote Debugger folder on the Visual Studio computer.

  3. No computador remoto, execute msvsmon.exe da pasta compartilhada.On the remote computer, run msvsmon.exe from the shared folder. Siga as instruções de instalação.Follow the setup instructions.

Dica

Para instalação de linha de comando e referência de linha de comando, consulte a página de ajuda para msvsmon.exe digitando msvsmon.exe /? na linha de comando no computador com o Visual Studio instalado (ou vá para ajuda > uso no depurador remoto).For command line installation and command line reference, see the Help page for msvsmon.exe by typing msvsmon.exe /? in the command line on the computer with Visual Studio installed (or go to Help > Usage in the remote debugger).

Configurar o depurador remotoSet up the remote debugger

  1. No computador remoto, localize e inicie o depurador remoto no menu Iniciar .On the remote computer, find and start the Remote Debugger from the Start menu.

    Se você não tiver permissões administrativas no computador remoto, clique com o botão direito do mouse no aplicativo do depurador remoto e selecione Executar como administrador.If you don't have administrative permissions on the remote computer, right-click the Remote Debugger app and select Run as administrator. Caso contrário, basta iniciá-lo normalmente.Otherwise, just start it normally.

    Se você estiver planejando anexar a um processo que está sendo executado como administrador ou que está sendo executado em uma conta de usuário diferente (como o IIS), clique com o botão direito do mouse no aplicativo do depurador remoto e selecione Executar como administrador.If you are planning to attach to a process which is running as an administrator, or is running under a different user account (such as IIS), right-click the Remote Debugger app and select Run as administrator. Para obter mais informações, consulte executar o depurador remoto como administrador.For more information, see Run the remote debugger as an administrator.

  2. Na primeira vez que você iniciar o depurador remoto (ou antes de configurá-lo), a caixa de diálogo configuração de depuração remota será exibida.The first time you start the remote debugger (or before you have configured it), the Remote Debugging Configuration dialog box appears.

    Configuração do depurador remotoRemote Debugger configuration

  3. Se a API dos serviços Web do Windows não estiver instalada, o que acontece apenas no Windows Server 2008 R2, selecione o botão instalar .If the Windows Web Services API is not installed, which happens only on Windows Server 2008 R2, select the Install button.

  4. Selecione pelo menos um tipo de rede no qual você deseja usar as ferramentas remotas.Select at least one network type you want to use the remote tools on. Se os computadores estiverem conectados por meio de um domínio, você deverá escolher o primeiro item.If the computers are connected through a domain, you must choose the first item. Se os computadores estiverem conectados por meio de um grupo de trabalho ou grupos domésticos, escolha o segundo ou terceiro item, conforme apropriado.If the computers are connected through a workgroup or homegroup, choose the second or third item as appropriate.

  5. Selecione Configurar depuração remota para configurar o firewall e iniciar o depurador remoto.Select Configure remote debugging to configure the firewall and start the remote debugger.

  6. Quando a configuração estiver concluída, a janela do depurador remoto será exibida.When configuration is complete, the Remote Debugger window appears.

    Janela do depurador remotoRemote Debugger window

    O depurador remoto agora está aguardando uma conexão.The remote debugger is now waiting for a connection. Use o nome do servidor e o número da porta mostrada para definir a configuração de conexão remota no Visual Studio.Use the server name and port number shown to set the remote connection configuration in Visual Studio.

Para interromper o depurador remoto, selecione arquivo > sair.To stop the remote debugger, select File > Exit. Você pode reiniciá-lo no menu Iniciar ou na linha de comando:You can restart it from the Start menu, or from the command line:

<Remote debugger installation directory>\msvsmon.exe

Configurar o depurador remotoConfigure the remote debugger

Você pode alterar alguns aspectos da configuração do depurador remoto depois de iniciá-lo pela primeira vez.You can change some aspects of the configuration of the remote debugger after you have started it for the first time.

  • Se você precisar adicionar permissões para que outros usuários se conectem ao depurador remoto, escolha ferramentas > permissões.If you need to add permissions for other users to connect to the remote debugger, choose Tools > Permissions. Você deve ter privilégios de administrador para conceder ou negar permissões.You must have administrator privileges to grant or deny permissions.

    Importante

    Você pode executar o depurador remoto em uma conta de usuário que seja diferente da conta de usuário que você está usando no computador do Visual Studio, mas você deve adicionar a conta de usuário diferente às permissões do depurador remoto.You can run the remote debugger under a user account that differs from the user account you are using on the Visual Studio computer, but you must add the different user account to the remote debugger's permissions.

    Como alternativa, você pode iniciar o depurador remoto a partir da linha de comando com o parâmetro <username> /Allow : msvsmon/Allow <username@computer>.Alternatively, you can start the remote debugger from the command line with the /allow <username> parameter: msvsmon /allow <username@computer>.

  • Se você precisar alterar o modo de autenticação ou o número da porta, ou especificar um valor de tempo limite para as ferramentas remotas: escolha ferramentas > opções.If you need to change the Authentication mode or the port number, or specify a timeout value for the remote tools: choose Tools > Options.

    Para obter uma lista dos números de porta usados por padrão, consulte atribuições de porta do depurador remoto.For a listing of the port numbers used by default, see Remote Debugger Port Assignments.

    Aviso

    Você também pode optar por executar as ferramentas remotas no Modo Sem Autenticação, mas isso é altamente desaconselhável.You can choose to run the remote tools in No Authentication mode, but this mode is strongly discouraged. Nesse modo, não há nenhuma segurança de rede.There is no network security when you run in this mode. Escolha o modo sem autenticação somente se você tiver certeza de que a rede não está em risco de tráfego mal-intencionado ou hostil.Choose the No Authentication mode only if you are sure that the network is not at risk from malicious or hostile traffic.

Adicional Configurar o depurador remoto como um serviço(Optional) Configure the remote debugger as a service

Para a depuração no ASP.NET e em outros ambientes de servidor, você deve executar o depurador remoto como administrador ou, se desejar que ele esteja sempre em execução, executar o depurador remoto como um serviço.For debugging in ASP.NET and other server environments, you must either run the remote debugger as an Administrator or, if you want it always running, run the remote debugger as a service.

Se você quiser configurar o depurador remoto como um serviço, siga estas etapas.If you want to configure the remote debugger as a service, follow these steps.

  1. Localize o Assistente de configuração do depurador remoto (rdbgwiz.exe).Find the Remote Debugger Configuration Wizard (rdbgwiz.exe). (Esse é um aplicativo separado do depurador remoto.) Ele está disponível somente quando você instala as ferramentas remotas.(This is a separate application from the Remote Debugger.) It is available only when you install the remote tools. Ele não é instalado com o Visual Studio.It is not installed with Visual Studio.

  2. Inicie a execução do assistente de configuração.Start running the configuration wizard. Quando a primeira página aparecer, clique em Avançar.When the first page comes up, click Next.

  3. Marque a caixa de seleção executar o depurador remoto do Visual Studio 2015 como um serviço .Check the Run the Visual Studio 2015 Remote Debugger as a service checkbox.

  4. Adicione o nome da conta de usuário e a senha.Add the name of the user account and password.

    Talvez seja necessário adicionar o direito de usuário fazer logon como um serviço a essa conta (localizar política de segurança local (secpol. msc) na página inicial ou na janela (ou digite secpol em um prompt de comando).You may need to add the Log on as a service user right to this account (Find Local Security Policy (secpol.msc) in the Start page or window (or type secpol at a command prompt). Quando a janela for exibida, clique duas vezes em atribuição de direitos de usuário e, em seguida, localize fazer logon como um serviço no painel direito.When the window appears, double-click User Rights Assignment, then find Log on as a service in the right pane. Clique duas vezes nesse item.Double-click it. Adicione a conta de usuário à janela Propriedades e clique em OK).Add the user account to the Properties window and click OK). Clique em Próximo.Click Next.

  5. Selecione o tipo de rede com o qual você deseja que as ferramentas remotas se comuniquem.Select the type of network that you want the remote tools to communicate with. Pelo menos um tipo de rede deve ser selecionado.At least one network type must be selected. Se os computadores estiverem conectados por meio de um domínio, você deverá escolher o primeiro item.If the computers are connected through a domain, you should choose the first item. Se os computadores estiverem conectados por meio de um grupo de trabalho ou grupos domésticos, você deverá escolher o segundo ou terceiro itens.If the computers are connected through a workgroup or homegroup, you should choose the second or third items. Clique em Próximo.Click Next.

  6. Se o serviço puder ser iniciado, você verá que concluiu com êxito o assistente de configuração de depurador remoto do Visual Studio.If the service can be started, you will see You have successfully completed the Visual Studio Remote Debugger Configuration Wizard. Se o serviço não puder ser iniciado, você verá falha ao concluir o assistente de configuração de depurador remoto do Visual Studio.If the service cannot be started, you will see Failed to complete the Visual Studio Remote Debugger Configuration Wizard. A página também fornece algumas dicas a serem seguidas para que o serviço seja iniciado.The page also gives some tips to follow to get the service to start.

  7. Clique em Concluir.Click Finish.

    Neste ponto, o depurador remoto está sendo executado como um serviço.At this point the remote debugger is running as a service. Você pode verificar isso indo até o painel de controle > serviços e procurando o depurador remoto do Visual Studio 2015.You can verify this by going to Control Panel > Services and looking for Visual Studio 2015 Remote Debugger.

    Você pode parar e iniciar o serviço de depurador remoto no painel de controle > serviços.You can stop and start the remote debugger service from Control Panel > Services.

Configurar a depuração com símbolos remotosSet up debugging with remote symbols

Você deve ser capaz de depurar seu código com os símbolos que você gera no computador do Visual Studio.You should be able to debug your code with the symbols you generate on the Visual Studio computer. O desempenho do depurador remoto é muito melhor quando você usa símbolos locais.The performance of the remote debugger is much better when you use local symbols. Se for necessário usar símbolos remotos, você precisará instruir o monitor de depuração remota a procurar por símbolos no computador remoto.If you must use remote symbols, you need to tell the remote debugging monitor to look for symbols on the remote machine.

A partir do Visual Studio 2013 atualização 2, você pode usar a seguinte opção de linha de comando do msvsmon para usar símbolos remotos para código gerenciado: Msvsmon /FallbackLoadRemoteManagedPdbsStarting in Visual Studio 2013 Update 2, you can use the following msvsmon command-line switch to use remote symbols for managed code: Msvsmon /FallbackLoadRemoteManagedPdbs

Para obter mais informações, consulte a ajuda de depuração remota (pressione F1 na janela do depurador remoto ou clique em ajuda > uso).For more information, please see the remote debugging help (press F1 in the remote debugger window, or click Help > Usage). Você pode encontrar mais informações em alterações de carregamento de símbolo remoto do .net no Visual Studio 2012 e 2013You can find more information at .NET Remote Symbol Loading Changes in Visual Studio 2012 and 2013

Confira tambémSee also