Compartilhar via


Solucionar problemas de conectividade do ambiente de desenvolvimento

Este guia de solução de problemas passo a passo pode ajudá-lo a encontrar e corrigir problemas de conexão do Microsoft Dev Box. Esses problemas podem incluir a incapacidade de se conectar, problemas de entrada, desconexões frequentes ou latências altas.

Pré-requisitos

Categoria Requirements
Tools Para criar ou acessar uma caixa de desenvolvimento, uma organização deve configurar o Microsoft Dev Box com pelo menos um projeto e um pool de caixas de desenvolvimento. Para configurar o Microsoft Dev Box para uma organização, consulte Início Rápido: Configurar o Microsoft Dev Box.
Tools Para se conectar a uma caixa de desenvolvimento com o Aplicativo Windows, instale o Aplicativo Windows em seu dispositivo cliente.
Permissions Para criar ou acessar uma caixa de desenvolvimento, você precisa de permissões de Usuário do Dev Box em um projeto que tenha um pool de caixas de desenvolvimento disponível. Se você não tiver permissões para um projeto, entre em contato com o administrador.

Possível solução alternativa rápida

Para identificar e resolver problemas no ambiente de desenvolvimento automaticamente, tente executar Troubleshoot & repair. Entre no portal do desenvolvedor e selecione Solucionar problemas e reparar no menu Mais ações no bloco da caixa de desenvolvimento. Para obter mais informações, consulte Resolver problemas de conectividade com a ferramenta Solução de Problemas e Reparo.

Lista de verificação de solução de problemas

  • Verifique se o dispositivo cliente tem uma conexão de Internet ativa.
  • Verifique se o dispositivo cliente e a caixa de desenvolvimento têm as atualizações de segurança e do sistema operacional mais recentes instaladas.
  • Verifique se você tem o aplicativo Windows mais recente instalado em seu dispositivo cliente.
  • Verifique se há configurações de rede inadequadas ou configurações de proxy de Internet em seu cliente ou caixa de desenvolvimento que possam interromper conexões remotas.
  • Confirme se o status do seu computador de desenvolvimento é Em execução. Se o status for Parado ou Hibernado, selecione Iniciar ou Retomar no menu Mais ações no bloco do computador de desenvolvimento no portal do desenvolvedor.
  • Verifique o Windows Update. Você não pode se conectar a uma caixa de desenvolvimento por até 30 minutos enquanto o Windows está atualizando.
  • Se você puder acessar sua caixa de desenvolvimento, examine as informações de segurança e conexão selecionando os ícones na barra de conexão superior durante uma sessão.
  • Revise os problemas de conectividade conhecidos em Solucionar problemas de conectividade conhecidos da Área de Trabalho Remota com caixas de desenvolvimento.

Problemas de conectividade remota

Se a conexão do aplicativo Windows com o ambiente de desenvolvimento travar ou falhar, tente as etapas a seguir para se conectar.

  1. Entre no portal do desenvolvedor e reinicie a caixa de desenvolvimento selecionando Reiniciar no menu Mais ações no bloco da caixa de desenvolvimento.
  2. Depois de reiniciado, tente se conectar novamente selecionando Conectar por meio do aplicativo windows.
  3. Tente se conectar por meio do navegador selecionando o cursor ao lado de Conectar por meio do aplicativo do Windows e, em seguida, selecionando Abrir no navegador.
  4. Saia e volte para o portal do desenvolvedor e tente se conectar novamente.
  5. Abra o Gerenciador de Tarefas e encerre todos os processos demsrdc.exe ou msrdcw.exe em execução. Em seguida, tente se conectar novamente.

Problemas de entrada e autenticação

Se você tiver problemas de entrada ou autenticação, apesar de usar as credenciais corretas, tente as seguintes etapas:

  1. Use dsregcmd.exe /status para verificar seu status de ingresso no Microsoft Entra ID no seu dispositivo cliente e no computador de desenvolvimento, se possível. Depois de resolver erros com sua equipe de suporte, reinicie o computador.
  2. Se você não acessar sua máquina de desenvolvimento por algum tempo, o Microsoft Entra ID poderá remover sua conta devido à inatividade. Para recuperar o acesso, entre em contato com sua equipe de suporte.
  3. Tente usar dsregcmd.exe /refreshprt para atualizar o PRT (Token de Atualização Primária) para uma sessão. Em seguida, saia e entre novamente.
  4. Se você tiver privilégios administrativos, tente usar dsregcmd.exe /forcerecovery para reautenticar e registrar novamente ou dsregcmd.exe /leave e dsregcmd.exe /join para sair e ingressar novamente no Microsoft Entra ID. Para obter mais informações, consulte Solucionar problemas de dispositivos usando o comando dsregcmd.
  5. Se você tiver privilégios de administrador no portal do Azure, talvez seja necessário cancelar a assinatura e assinar novamente o computador de desenvolvimento no pool de computadores de desenvolvimento excluindo e recriando o pool.

Problemas de conexão durante a alta carga de CPU

Se você tiver quedas de conexão frequentes durante o uso intensivo de CPU na máquina de desenvolvimento, poderá aplicar uma configuração de registro para dar mais prioridade de GPU a sessões de conexão remota.

  1. Verifique se a caixa de desenvolvimento tem o build mais recente do Windows 11.

  2. Abra o Editor do Registro na caixa de desenvolvimento e adicione a seguinte configuração do Registro.

    Chave: HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations
    Configuração: SetGpuRealtimePriority
    Valor: DWORD 2

    Como alternativa, você pode adicionar e definir a configuração e o valor do Registro SetGpuRealtimePriority executando este comando em um shell com privilégios elevados:

    reg add "HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations" /v SetGpuRealtimePriority /d 2 /t REG_DWORD
    
  3. Reinicie o computador de desenvolvimento.

Problemas de conexão durante o baixo uso da CPU

Se você tiver quedas de conexão frequentes mesmo com baixo uso de CPU na máquina de desenvolvimento, poderá configurar sua conexão de área de trabalho remota para usar o TCP (Protocolo de Controle de Transmissão) em vez do UDP (Protocolo de Datagrama do Usuário). Para garantir que a conexão use apenas TCP, altere as configurações no dispositivo cliente e na caixa de desenvolvimento.

Configurações de cliente

Diga explicitamente ao cliente para não tentar uma conexão UDP.

  1. Abra o Editor gpedit.mscde Política de Grupo Local.
  2. Vá para Configuração do Computador>Modelos Administrativos>Componentes do Windows>Serviços de Área de Trabalho Remota>Cliente de Conexão de Área de Trabalho Remota.
  3. Defina a configuração de política Desativar o cliente UDP On como Habilitado e selecione OK.

Como alternativa, você pode editar o registro para adicionar a seguinte configuração fClientDisableUDP :

Chave: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows NT\Terminal Services\Client
Configuração: fClientDisableUDP
Valor: DWORD 1

Você também pode aplicar a configuração e o valor do registro fClientDisableUDP executando o seguinte comando em um shell com privilégios elevados:

reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows NT\Terminal Services\Client" /v fClientDisableUDP /d 1 /t REG_DWORD

Configurações do host

Use o Editor de Política de Grupo para definir os protocolos de transporte de área de trabalho remota em sua caixa de desenvolvimento para usar apenas TCP.

  1. No computador de desenvolvimento, abra o Editor de Política de Grupo Local gpedit.msc.
  2. Acesse Configuração do Computador>Modelos Administrativos>Componentes do Windows>Serviços de Área de Trabalho Remota>Host de Sessão de Área de Trabalho Remota>Conexões.
  3. Defina a configuração de política Selecionar protocolos de transporte RDP como Habilitados.
  4. Para Selecionar Tipo de Transporte, selecione Usar apenas TCP e, em seguida, selecione OK.

Depois de fazer essas alterações, execute gpupdate /force em um shell com privilégios elevados em ambos os computadores e reinicie-as.

Obtenha suporte

Se as etapas anteriores não resolverem seu problema, você poderá entrar em contato com sua equipe de administração, acessar mais recursos de suporte ou registrar uma solicitação de suporte.

No portal do desenvolvedor, selecione Suporte no menu Mais ações em um ícone de dev box para abrir o painel de suporte da caixa Dev. No painel, você pode:

  • Selecione o link diagnosticar sua caixa de desenvolvimento para solucionar problemas da caixa de desenvolvimento. Para obter mais informações, consulte Resolver problemas de conectividade com a ferramenta Solução de Problemas e Reparo.
  • Selecione Copiar detalhes de suporte para copiar detalhes sobre sua caixa de desenvolvimento e uma ID de problema que você pode dar ao administrador ou à equipe de suporte.
  • Selecione o link contatar a ajuda e o suporte do Azure para abrir a página Ajuda e suporte do portal do Azure para o seu projeto de computador de desenvolvimento. Na página Ajuda + suporte , você pode selecionar Solucionar problemas em Ações para percorrer as etapas de solução de problemas ou selecionar Criar uma solicitação de suporte para percorrer a criação de uma solicitação de suporte.

Se você arquivar uma solicitação de suporte, inclua:

  • Uma descrição detalhada do problema.
  • A hora em que o problema ocorreu.
  • Usuários afetados.
  • Outras informações sobre o ambiente de desenvolvimento e a sessão remota, se disponíveis, como ID de Atividade.

Obter informações de conexão e segurança do dev box

Se você puder acessar sua caixa de desenvolvimento, poderá obter informações de segurança e conexão selecionando o ícone correspondente na barra de conexão superior durante a sessão.

Captura de tela que mostra a barra de conexão de Área de Trabalho Remota.

Para ver os detalhes da conexão, como Carimbo de Data/Hora e ID da Atividade, selecione Ver detalhes na caixa de diálogo de conexão. Copie os detalhes da conexão pressionando Ctrl+C e feche a caixa de diálogo selecionando OK.

Captura de tela que mostra a caixa de diálogo com informações de solução de problemas de conexão.