Depuração remota

Você pode depurar uma aplicação do Visual Studio que foi implantada num computador diferente. Para fazer isso, use o depurador remoto do Visual Studio.

Para obter instruções detalhadas sobre depuração remota, consulte estes tópicos.

Se você quiser apenas baixar e instalar o depurador remoto e não precisar de instruções adicionais para o seu cenário, siga as etapas neste artigo.

Baixe e instale as ferramentas remotas

No dispositivo remoto ou servidor em que você deseja depurar, em vez da máquina do Visual Studio, baixe e instale a versão correta das ferramentas remotas a partir dos links na tabela a seguir.

• Baixe a atualização mais recente das ferramentas remotas para sua versão do Visual Studio. Versões anteriores de ferramentas remotas não são compatíveis com versões posteriores do Visual Studio. (Por exemplo, se você estiver usando o Visual Studio 2019, baixe a atualização mais recente das ferramentas remotas para o Visual Studio 2019. Nesse cenário, não baixe as ferramentas remotas para o Visual Studio 2022.)
• Transfira as ferramentas remotas com a mesma arquitetura da máquina em que está a instalá-las. Por exemplo, se você quiser depurar aplicativos x86 em um computador remoto executando um sistema operacional x64, instale as ferramentas remotas x64. Para depurar aplicativos x86, ARM ou x64 em um sistema operacional ARM64, instale as ferramentas remotas ARM64.

Você pode executar o depurador remoto copiando msvsmon.exe para o computador remoto, em vez de instalar as ferramentas remotas. No entanto, o Assistente de Configuração do Depurador Remoto (rdbgwiz.exe) está disponível somente quando você instala as ferramentas remotas. Se quiser executar o depurador remoto como um serviço, talvez seja necessário usar o assistente para configuração. Para obter mais informações, consulte (opcional) Configurar o depurador remoto como um serviço.

Requerimentos

Sistemas Operativos Suportados

O computador remoto deve estar executando um dos seguintes sistemas operacionais:

• Windows 11

• Windows 10 (não telefone)

• Windows 8 ou 8.1 (não telefone)

• Windows 7 Service Pack 1

• Windows Server 2016

• Windows Server 2012 ou Windows Server 2012 R2

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

Configurações de hardware suportadas

• Processador de 1,6 GHz ou mais rápido

• 1 GB de RAM (1,5 GB se executado em uma máquina virtual)

• 1 GB de espaço disponível no disco rígido

• Disco rígido de 5400 RPM

• Placa de vídeo compatível com DirectX 9 com resolução de vídeo de 1024 x 768 ou superior

Configuração de rede

O computador remoto e o computador Visual Studio devem estar conectados através de uma rede, grupo de trabalho ou grupo doméstico, ou então conectados diretamente através de um cabo Ethernet. Não há suporte para depuração entre dois computadores conectados por meio de um proxy. A depuração através de uma ligação de alta latência ou baixa largura de banda, como a Internet por acesso telefónico, ou através da Internet entre países/regiões não é recomendada e pode falhar ou ser inaceitavelmente lenta.

(Opcional) Para executar o depurador remoto a partir de um compartilhamento de arquivos

Pode encontrar o depurador remoto (msvsmon.exe) num computador que já tenha o Visual Studio Community, Professional ou Enterprise instalado. Para alguns cenários, a maneira mais fácil de configurar a depuração remota é executar o depurador remoto (msvsmon.exe) a partir de um compartilhamento de arquivos. Para obter limitações de uso, consulte a página de Ajuda do depurador remoto (Ajuda > Uso no depurador remoto).

1. Encontre msvsmon.exe no diretório correspondente à sua versão do Visual Studio:

   Arquivos de Programas\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x64\msvsmon.exe

   Arquivos de Programas\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x86\msvsmon.exe

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

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

2. Compartilhe a pasta Remote Debugger no computador do Visual Studio.

3. No computador remoto, execute msvsmon.exe a partir da pasta compartilhada. Siga as instruções de configuração .

Configurar o depurador remoto

1. No computador remoto, localize e inicie o Depurador Remoto do menu Iniciar.

   Se não tiver permissões administrativas no computador remoto, clique com o botão direito do rato na aplicação Depurador Remoto e selecione Executar como administrador. Caso contrário, basta iniciá-lo normalmente.

   Se você estiver planejando anexar a um processo que está sendo executado como administrador ou está sendo executado em uma conta de usuário diferente (como o IIS), clique com o botão direito do mouse no aplicativo Depurador Remoto e selecione Executar como administrador. Para obter mais informações, consulte Executar o depurador remoto como administrador.

2. Na primeira vez que se iniciar o depurador remoto (ou antes de o configurar), será exibido o assistente de configuração de depuração remota .

   Na maioria dos cenários, escolha Avançar até chegar à página Configurar o Firewall do Windows do assistente.

   

   

   Se a API do Windows Web Services não estiver instalada, o que acontece apenas no Windows Server 2008 R2, selecione o botão Instalar.

3. Selecione pelo menos um tipo de rede no qual você deseja usar as ferramentas remotas. Se os computadores estiverem conectados através de um domínio, você deverá escolher o primeiro item. Se os computadores estiverem conectados por meio de um grupo de trabalho ou grupo doméstico, escolha o segundo ou terceiro item conforme apropriado.

   Em seguida, selecione Concluir para iniciar o depurador remoto.

   Em seguida, selecione Configurar depuração remota para iniciar o depurador remoto.

4. Quando a configuração estiver concluída, a janela Remote Debugger será exibida.

   

   

   O depurador remoto está agora à espera de uma ligação. Use o nome do servidor e o número da porta mostrados para definir a configuração de conexão remota no Visual Studio.

Para interromper o depurador remoto, selecione Arquivo>Sair. Você pode reiniciá-lo a partir do menu Iniciar ou da linha de comando:

<Remote debugger installation directory>\msvsmon.exe

Configurar o depurador remoto

Você pode alterar alguns aspetos da configuração do depurador remoto depois de iniciá-lo pela primeira vez.

• Se você precisar adicionar permissões para que outros usuários se conectem ao depurador remoto, escolha Ferramentas > Permissões. Você deve ter privilégios de administrador para conceder ou negar permissões.

  Importante

  Você pode executar o depurador remoto em uma conta de usuário que difere da conta de usuário que você está usando no computador Visual Studio, mas você deve adicionar a conta de usuário diferente para as permissões do depurador remoto.

  Como alternativa, você pode iniciar o depurador remoto a partir da linha de comando com o parâmetro /allow <username>: 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.

  Para obter uma lista dos números de porta usados por padrão, consulte Remote Debugger Port Assignments.

  Advertência

  Você pode optar por executar as ferramentas remotas no modo Sem Autenticação, mas esse modo é fortemente desencorajado. Não há segurança de rede quando você executa nesse modo. Escolha o modo Sem autenticação somente se tiver certeza de que a rede não está em risco de tráfego mal-intencionado ou hostil.

(Opcional) Configurar o depurador remoto para funcionar como serviço

Para depuração em ambientes ASP.NET e outros servidores, você deve executar o depurador remoto como um administrador ou, se quiser que ele esteja sempre em execução, executar o depurador remoto como um serviço.

Se quiser configurar o depurador remoto como um serviço, siga estes passos.

1. Encontre o Assistente de Configuração do Depurador Remoto (rdbgwiz.exe). (Este é um aplicativo separado do Depurador Remoto.) Ele está disponível somente quando você instala as ferramentas remotas. Ele não é instalado com o Visual Studio.

2. Comece a executar o assistente de configuração. Quando a primeira página aparecer, clique em Avançar.

3. Marque a caixa de seleção Executar o depurador remoto do Visual Studio como um serviço.

4. Adicione o nome da conta de utilizador e a palavra-passe.

   Talvez seja necessário adicionar o direito de utilizador Iniciar sessão como um serviço a esta conta (Localizar Diretiva de Segurança Local (secpol.msc) na página ou janela Iniciar (ou digite secpol em um prompt de comando). Quando a janela aparecer, faça duplo clique em Atribuição de Direitos de Utilizador, e em seguida, localize Fazer logon como um serviço no painel direito. Clique duas vezes nele. Adicione a conta de usuário à janela Propriedades e clique em OK). Clique Avançar.

5. Selecione o tipo de rede com o qual você deseja que as ferramentas remotas se comuniquem. Pelo menos um tipo de rede deve ser selecionado. Se os computadores estiverem conectados através de um domínio, você deverá escolher o primeiro item. Se os computadores estiverem conectados por meio de um grupo de trabalho ou grupo doméstico, você deverá escolher o segundo ou terceiro itens. Clique Avançar.

6. Se o serviço puder ser iniciado, você verá concluiu com êxito o Assistente de Configuração do Depurador Remoto do Visual Studio. Se o serviço não puder ser iniciado, você verá Falha ao concluir o Assistente de Configuração do Depurador Remoto do Visual Studio. A página também dá algumas dicas a seguir para que o serviço comece.

7. Clique Concluir.

   Neste momento, o depurador remoto está a ser executado como um serviço. Você pode verificar isso indo para Painel de Controle > Services e procurando Visual Studio Remote Debugger.

   Pode parar e iniciar o serviço de depuração remota a partir do Painel de Controlo > Serviços.

Configurar a depuração com símbolos remotos

Você deve ser capaz de depurar seu código com os símbolos gerados no computador Visual Studio. O desempenho do depurador remoto é muito melhor quando você usa símbolos locais. Se tiver de usar símbolos remotos, necessitará de avisar o monitor de depuração remota para que procure símbolos na máquina remota.

Você pode usar a seguinte opção de linha de comando msvsmon para usar símbolos remotos para código gerenciado: 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).

Conteúdo relacionado

• Primeira olhada no depurador
• Configurar o Firewall do Windows para depuração remota
• Atribuições de porta do depurador remoto
• Depuração Remota do ASP.NET Core em Computador IIS Remoto
• Erros de depuração remota e resolução de falhas