Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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
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.
- Entre no portal do desenvolvedor e reinicie a caixa de desenvolvimento selecionando Reiniciar no menu Mais ações no bloco da caixa de desenvolvimento.
- Depois de reiniciado, tente se conectar novamente selecionando Conectar por meio do aplicativo windows.
- 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.
- Saia e volte para o portal do desenvolvedor e tente se conectar novamente.
- 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:
- Use
dsregcmd.exe /statuspara 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. - 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.
- Tente usar
dsregcmd.exe /refreshprtpara atualizar o PRT (Token de Atualização Primária) para uma sessão. Em seguida, saia e entre novamente. - Se você tiver privilégios administrativos, tente usar
dsregcmd.exe /forcerecoverypara reautenticar e registrar novamente oudsregcmd.exe /leaveedsregcmd.exe /joinpara sair e ingressar novamente no Microsoft Entra ID. Para obter mais informações, consulte Solucionar problemas de dispositivos usando o comando dsregcmd. - 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.
Verifique se a caixa de desenvolvimento tem o build mais recente do Windows 11.
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 2Como 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_DWORDReinicie 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.
- Abra o Editor
gpedit.mscde Política de Grupo Local. - 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.
- 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.
- No computador de desenvolvimento, abra o Editor de Política de Grupo Local
gpedit.msc. - 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.
- Defina a configuração de política Selecionar protocolos de transporte RDP como Habilitados.
- 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.
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.