Depuração remota

Pode depurar uma aplicação Visual Studio que tenha sido implementada num computador diferente. Para isso, utiliza-se o depurador remoto do Visual Studio.

Para obter instruções pormenorizadas 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 onde pretende depurar, em vez da máquina do Visual Studio, descarregue e instale a versão correta das ferramentas remotas a partir dos links na tabela seguinte.

• 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. Talvez seja necessário utilizar o assistente de configuração se quiser executar o depurador remoto como um serviço. Para obter mais informações, consulte (Opcional) Configurar o depurador remoto como um serviço.

Requerimentos

Requisitos de sistema

As ferramentas remotas suportam os mesmos requisitos de sistema do Visual Studio, com algumas alterações. Para mais detalhes, consulte os requisitos do sistema para a sua versão do Visual Studio:

Configuração de rede

O computador remoto e o computador do Visual Studio devem estar ligados através de uma rede, grupo de trabalho ou grupo doméstico, ou então ligados diretamente por 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 com Visual Studio Community, Professional ou Enterprise já 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 consultar as limitações de uso, veja a página de Ajuda do depurador remoto (Ajuda > Uso no depurador remoto).

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

   Program Files\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x64\msvsmon.exe

   Program Files\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x86\msvsmon.exe

2. Partilhe a pasta Remote Debugger no Visual Studio computador.

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 a partir 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 estiver a planear ligar-se a um processo que está a ser executado como administrador, ou está a ser executado numa conta de utilizador diferente (como o IIS), clique com o botão direito do rato na aplicação 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, selecione Configurar depuração remota.

   

   Na maioria dos cenários, escolhe Next até chegares à página Configure o Windows Firewall do assistente.

   

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, escolha Finalizar para iniciar o depurador remoto.

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

   

   

   O depurador remoto está neste momento à espera de uma ligação. Use o nome do servidor e o número de porta mostrados para definir a configuração da ligaçã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

  Pode executar o depurador remoto com uma conta de utilizador que seja diferente da conta de utilizador que está a usar no computador Visual Studio, mas deve adicionar a conta de utilizador diferente às 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.

Configure o Visual Studio para depuração remota

Para instruções detalhadas para se ligar à aplicação a partir do Visual Studio, utilize os links relacionados com o seu cenário específico no início deste artigo.

Alguns cenários exigem o uso de Anexar ao Processo para se conectar a uma aplicação remota já em execução. No entanto, para aplicações .NET Core, .NET 5+, .NET Framework e C++, pode iniciar a aplicação remota a partir do Visual Studio configurando as propriedades do projeto e iniciando o depurador. Para mais informações, veja Depurar remotamente um projeto C# ou Visual Basic ou Depurar remotamente um projeto C++.

Também pode depurar remotamente um executável que não faça parte de um projeto do Visual Studio, embora as funcionalidades de depuração suportadas dependam da configuração, como a disponibilidade de símbolos. Para mais informações, consulte Depurar uma aplicação que não faça parte de uma solução Visual Studio.

(Opcional) Configurar o depurador remoto como um serviço

Para depuração em ASP.NET e outros ambientes de servidor, deve executar o depurador remoto como Administrador ou, se quiser que esteja sempre a funcionar, executar o depurador remoto como serviço.

Se pretender configurar o depurador remoto como 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. Não está 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. Assinala a caixa Executar o Depurador Remoto Visual Studio como 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 janela ou página Iniciar (ou digite secpol num prompt de comando). Quando a janela for exibida, clique duas vezes em Atribuição de Direitos de Utilizadore, em seguida, localize Iniciar sessão como um serviço no painel direito. Clique duas vezes nele. Adicione a conta de utilizador à janela Propriedades e clique em OK). Clique em Next.

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 em Next.

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

7. Clique em Concluir.

   Neste ponto o depurador remoto está a ser executado como um serviço. Podes verificar isto indo a Painel de Controlo > Services e procurando por Visual Studio Depurador Remoto.

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

Configurar a depuração com símbolos remotos

Deverias conseguir depurar o teu código com os símbolos que geras no computador do Visual Studio. O desempenho do depurador remoto é muito melhor quando você usa símbolos locais. Se tiver de usar símbolos remotos, precisará informar o monitor de depuração remota para procurar 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 > Utilização).

Conteúdo relacionado

• Introdução ao depurador
• Configure o Firewall do Windows para depuração remota
• Atribuições de porta do depurador remoto
• Depuração Remota de ASP.NET Core num computador IIS remoto
• Erros de depuração remota e solução de problemas