Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Este guia passo a passo de resolução de problemas pode ajudá-lo a encontrar e corrigir problemas de ligação à Microsoft Dev Box. Estes problemas podem incluir incapacidade de ligar, problemas de iniciação de sessão, desconexões frequentes ou latências elevadas.
Pré-requisitos
| Categoria | Requerimentos |
|---|---|
| Tools | Para criar ou aceder a uma dev box, uma organização deve configurar a Microsoft Dev Box com pelo menos um projeto e um dev box pool. Para configurar o Microsoft Dev Box para uma organização, veja Quickstart: Configurar o Microsoft Dev Box. |
| Tools | Para se conectar a uma caixa de desenvolvimento com a aplicação Windows, instale a aplicação Windows no seu dispositivo cliente. |
| Permissions | Para criar ou aceder a uma dev box, precisas de permissões de utilizador do Dev Box num projeto que tenha um pool de dev box disponível. Se não tiver permissões para um projeto, contacte o seu administrador. |
Possível solução rápida
Para identificar e resolver automaticamente os problemas da dev box, tente correr o Troubleshoot & Repair. Inicia sessão no portal do programador e seleciona Resolução de Problemas e reparação no menu Mais ações na caixa de desenvolvimento. Para mais informações, consulte Resolver problemas de conectividade com a ferramenta de Resolução de Problemas e Reparação.
Lista de verificação de solução de problemas
- Verifique se o seu dispositivo cliente tem uma ligação ativa à internet.
- Certifique-se de que o seu dispositivo cliente e a máquina de desenvolvimento têm as últimas atualizações do sistema operativo e de segurança instaladas.
- Certifique-se de que tem a aplicação Windows mais recente instalada no seu dispositivo cliente.
- Verifica se há configurações de rede incorretas ou definições de proxy de internet no teu cliente ou na caixa de desenvolvimento que possam perturbar ligações remotas.
- Confirma que o estado da tua dev box está em execução. Se o estado for Parado ou Hibernado, selecione Iniciar ou Retomar no menu Mais ações na caixa de desenvolvimento do portal de programadores.
- Verifica o Windows Update. Não podes ligar-te a uma dev box durante até 30 minutos enquanto o Windows está a atualizar.
- Se conseguires aceder à tua dev box, revê as informações de segurança e ligação selecionando os ícones na barra de ligação superior durante uma sessão.
- Veja problemas de conectividade conhecidos em Resolução de problemas de conectividade conhecidos na Área de Trabalho Remota com dev boxes.
Problemas de conectividade remota
Se a ligação da aplicação Windows à caixa de desenvolvimento ficar suspensa ou falhar, siga os passos seguintes para se conectar.
- Inicia sessão no portal de programadores e reinicia a caixa de desenvolvimento selecionando Reiniciar no menu Mais ações na caixa de desenvolvimento.
- Depois de reiniciado, tente ligar novamente selecionando Ligar via aplicação Windows.
- Tente ligar-se pelo navegador selecionando o cursor ao lado de Ligar via aplicação Windows e depois selecionar Abrir no navegador.
- Saia e volte ao portal para programadores, e tente ligar-se novamente.
- Abre o Gestor de Tarefas e termina quaisquer processosmsrdc.exe ou msrdcw.exe em execução. Em seguida, tente ligar novamente.
Problemas de início de sessão e autenticação
Se tiver problemas de login ou autenticação apesar de usar as credenciais corretas, experimente os seguintes passos:
- Use
dsregcmd.exe /statuspara verificar, se possível, o estado de associação do seu Microsoft Entra ID no seu dispositivo cliente e, se possível, na sua máquina de desenvolvimento. Depois de resolver quaisquer erros com a sua equipa de suporte, reinicie a máquina. - Se não aceder à sua dev box durante algum tempo, o Microsoft Entra ID pode remover a sua conta devido à inatividade. Para recuperar o acesso, contacte a sua equipa de suporte.
- Tente usar
dsregcmd.exe /refreshprtpara atualizar o Token de Atualização Primário (PRT) durante uma sessão. Depois sai e volta a entrar. - Se tiver privilégios administrativos, tente usar
dsregcmd.exe /forcerecoverypara reautenticar e registar-se novamente, ou usedsregcmd.exe /leavepara sair edsregcmd.exe /joinpara voltar a entrar no Microsoft Entra ID. Para mais informações, consulte Resolução de problemas de dispositivos usando o comando dsregcmd. - Se tiver privilégios de administrador no portal Azure, poderá ser necessário cancelar a subscrição e voltar a subscrever a dev box no grupo de dev boxes, eliminando e recriando o pool.
Problemas de ligação durante cargas elevadas do CPU
Se experienciares quedas frequentes de ligação durante uma carga elevada de CPU na dev box, podes aplicar uma definição de registo para dar mais prioridade à GPU nas sessões de ligação remota.
Certifica-te de que a tua dev box tem a versão mais recente do Windows 11.
Abra o Editor de Registo na caixa de desenvolvimento e adicione a seguinte definição de registo.
Chave: HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations
Definição: SetGpuRealtimePriority
Valor: DWORD 2Em alternativa, pode adicionar e definir a configuração e o valor do registo SetGpuRealtimePriority executando este comando numa shell com privilégios elevados:
reg add "HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations" /v SetGpuRealtimePriority /d 2 /t REG_DWORDReinicia a caixa de desenvolvimento.
Problemas de ligação durante baixa utilização do CPU
Se tiver quebras de ligação frequentes mesmo com baixo uso de CPU na máquina de desenvolvimento, pode mudar a sua ligação ao ambiente de trabalho remoto para usar o Protocolo de Controlo de Transmissão (TCP) em vez do Protocolo de Datagrama do Utilizador (UDP). Para garantir que a ligação usa apenas TCP, altere as definições tanto no dispositivo cliente como na dev box.
Definições do cliente
Diz explicitamente ao cliente para não tentar uma ligação UDP.
- Abra o Editor
gpedit.mscde Políticas de Grupo Local. - Vá a Configuração do Computador>Modelos Administrativos>Componentes do Windows>Serviços de Ambiente de Trabalho Remoto>Cliente de Conexão de Ambiente de Trabalho Remoto.
- Defina a definição de política Desligar o UDP no Clientepara Ativado e depois selecione OK.
Alternativamente, pode editar o registo para adicionar a seguinte definição fClientDisableUDP :
Chave: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows NT\Terminal Services\Client
Definição: fClientDisableUDP
Valor: DWORD 1
Também pode aplicar a definição e o valor do registo fClientDisableUDP executando o seguinte comando num terminal 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
Usa o Group Policy Editor para definir os protocolos de transporte do ambiente de trabalho remoto na tua dev box para usarem apenas TCP.
- Na sua dev box, abra o Editor de Política de Grupo Local
gpedit.msc. - Ir a Configuração do Computador>Modelos Administrativos>Componentes do Windows>Serviços de Ambiente de Trabalho Remoto>Anfitrião da Sessão de Ambiente de Trabalho Remoto>Conexões.
- Defina a definição de política Selecionar protocolos de transporte RDP para Ativado.
- Para Selecionar Tipo de Transporte, selecione Usar apenas TCP e depois selecione OK.
Depois de fazer estas alterações, execute gpupdate /force em um terminal com privilégios elevados em ambas as máquinas e reinicie-as.
Obtenha suporte
Se os passos anteriores não resolverem o seu problema, pode contactar a sua equipa administrativa, aceder a mais recursos de suporte ou apresentar um pedido de suporte.
No portal de programadores, selecione Suporte no menu Mais ações numa caixa de desenvolvimento para abrir o painel de suporte da caixa de desenvolvimento . No painel, pode:
- Seleciona o link resolver problemas da tua dev box para resolver questões da dev box. Para mais informações, consulte Resolver problemas de conectividade com a ferramenta de Resolução de Problemas e Reparação.
- Selecione Copiar detalhes de suporte para copiar detalhes sobre a sua caixa de desenvolvimento e um ID de Problema que possa fornecer ao seu administrador ou equipa de suporte.
- Selecione o link de ajuda + suporte do Azure para abrir a página de Ajuda + suporte no portal Azure para o seu projeto dev box. Na página Ajuda + suporte, pode selecionar Resolução de Problemas em Ações para percorrer os passos de resolução de problemas, ou selecionar Criar um pedido de suporte para guiar a criação de um pedido de suporte.
Se apresentar um pedido de apoio, inclua:
- Uma descrição detalhada do problema.
- A hora em que o problema ocorreu.
- Utilizadores afetados.
- Outras informações sobre a sua dev box e sessão remota, se disponíveis, como ID de Atividade.
Obtenha informações de ligação e segurança da dev box
Se conseguires aceder à tua dev box, podes obter informações de segurança e ligação selecionando o ícone correspondente na barra superior de ligação durante a sessão.
Para ver detalhes da ligação, como carimbo temporal e ID de atividade, selecione Ver detalhes na caixa de diálogo de ligação. Copie os detalhes da ligação pressionando Ctrl+C e feche o diálogo selecionando OK.