​

Perguntas frequentes e guia de solução de problemas do XBOX PC Remote Tools

​

Perguntas frequentes

​

Qual é a diferença entre os tipos de dispositivo Fully Managed e Lightweight?

​

Onde posso encontrar o número da versão do app?

​

Quais são os problemas conhecidos, as dependências e as limitações?

​

Problemas conhecidos

1. A configuração do PowerShell/DSC pode falhar e o XBOX PC Toolbox pode fechar inesperadamente durante a configuração.
   • Solução alternativa: veja O provisionamento do PowerShell e do DSC falha durante a configuração.
2. Dispositivos de destino ingressados em domínio: apenas a autenticação baseada em senha é compatível com conexões OpenSSH no modo Fully Managed (a autenticação baseada em chave é preferível, mas não está disponível). O provisionamento Lightweight está disponível como alternativa para dispositivos ingressados em domínio.
   • Observação: este problema afeta dispositivos Windows Pro ingressados em domínio que usam o modo Fully Managed. A equipe está trabalhando com as equipes do OpenSSH e do Microsoft Entra ID em melhorias futuras.
3. Erros de comandos do WinGet (por exemplo, winget search falha)
   • Solução alternativa: reinicie o dispositivo de destino. A equipe do produto está investigando esse problema.
4. Desempenho do depurador do Visual Studio: o XBOX PC Remote Debugger ainda não está otimizado para desempenho. Espere tempos de depuração mais lentos em comparação com a depuração local. Uma versão futura melhorará o desempenho do depurador.
5. O XBOX PC Remote Debugger pode parar de responder após várias iterações de depuração. Reinicie o dispositivo de destino após aproximadamente 50 iterações.
   • Solução alternativa: reinicie o dispositivo de destino e, em seguida, reinicie a sessão do depurador.

​

Dependências e limitações

• Ambos os dispositivos precisam de acesso à internet durante a configuração.
• Os dispositivos devem estar na mesma rede local e conseguir executar ping um no outro.
• O app XBOX PC Toolbox só está disponível na sandbox RETAIL. Verifique se os dispositivos estão no modo RETAIL para baixá-lo da Microsoft Store.
• Dispositivos compatíveis: Windows 10 ou Windows 11, edições Home ou Pro.
• É necessário acesso físico a ambos os dispositivos durante a configuração.
• É necessário acesso de administrador em ambos os dispositivos para a configuração.
• Dispositivos de destino ingressados no Microsoft Entra ID são compatíveis apenas por meio do provisionamento Lightweight. O modo Fully Managed não está disponível para dispositivos ingressados no Entra. O app detecta isso automaticamente e desabilita a opção Fully Managed durante a configuração.

​

Desemparelhar a partir do meu PC de desenvolvimento desconecta totalmente o dispositivo?

​

Como encontro as informações de conexão do dispositivo?

# Open a PowerShell 7 terminal
$env:ComputerName  # Device name
$env:Username      # Username  
ipconfig           # IP address

​

Como verifico as alterações de configuração nos dispositivos?

# Open a PowerShell 7 terminal on the DevPC
dsc config test -f "$env:LOCALAPPDATA\XboxPCDeviceManager\config\devPC.dsc.yaml"

# Network (usable on either device)  
dsc config test -f "$env:LOCALAPPDATA\XboxPCDeviceManager\config\network.dsc.yaml"

# Open a PowerShell 7 terminal on TargetDevice
dsc config test -f "$env:LOCALAPPDATA\XboxPCDeviceManager\config\targetDevice.dsc.yaml"

​

Como verifico e altero a sandbox?

​

Como seleciono um adaptador de rede específico para a configuração do canal seguro?

​

Como posso relatar um problema?

• A versão do sistema operacional (build do Windows 10/11)
• A versão do PowerShell ($PSVersionTable) para problemas do XBOX Device Management PowerShell Module
• A configuração de rede (Wi-Fi/Ethernet, corporativa/doméstica)
• As mensagens de erro (texto exato)
• As etapas para reproduzir
• Qual ferramenta você usou (XBOX PC Toolbox, XBOX Device Management PowerShell Module, wdRemote ou wdEndpoint)
• A versão prévia

​

Qual é a diferença entre o XBOX Device Management PowerShell Module (XDM) e o wdRemote/wdEndpoint?

• XDM: configura canais de comunicação seguros.
• wdRemote/wdEndpoint: implanta e inicia jogos por meio desses canais.

​

Preciso do XDM e do wdRemote/wdEndpoint?

​

Por que executar o wdEndpoint como administrador na primeira vez?

​

Posso implantar vários jogos no mesmo dispositivo de destino?

​

O que acontece se a conexão de rede cair durante a implantação?

​

Toda a comunicação é criptografada?

​

Qual ferramenta devo usar para cada tarefa?

• XBOX PC Toolbox: use-o para provisionar e adquirir dispositivos remotamente, configurar canais seguros, instalar dependências e configurar dispositivos.
• Testar a conectividade: use o XBOX PC Toolbox antes de implantar jogos.
• Sessões remotas: use sessões remotas habilitadas pelo XDM e a comunicação remota do PowerShell para executar comandos no dispositivo de destino.
• wdRemote/wdEndpoint: use essas ferramentas para implantar, testar e encerrar jogos.

​

Posso usar essas ferramentas com qualquer jogo do Windows?

​

Quais portas de rede essas ferramentas usam?

• XDM: SSH (porta 22)
• wdEndpoint: HTTPS (porta 4275)

​

Guia de solução de problemas

​

O emparelhamento falha em um ambiente de rede corporativa

• Verifique se ambos os dispositivos estão visíveis um para o outro na rede. Firewalls corporativos ou a segmentação de rede podem bloquear a comunicação entre dispositivos.
• Verifique se as seguintes portas estão abertas entre os dispositivos: porta 22 (OpenSSH) e porta 4275 (ferramentas de iteração remota).
• Desconecte-se de qualquer VPN antes de tentar emparelhar ou conectar.
• Se sua organização exigir o registro de dispositivos, confirme se seu dispositivo está registrado de acordo com as políticas de TI.

​

Erro ao instalar as ferramentas necessárias

• Solução alternativa: exclua os diretórios dos módulos em %onedrive%/Documents/PowerShell/Modules/ e tente novamente.
• Causa: o OneDrive pode interferir na instalação de módulos do PowerShell.

​

O provisionamento do PowerShell e do DSC falha durante a configuração

• Abra um terminal com privilégios elevados e execute:

winget uninstall Microsoft.PowerShell
winget uninstall Microsoft.DSC
winget install Microsoft.PowerShell --installer-type wix
winget install Microsoft.DSC --installer-type zip

• Se a configuração travar durante a instalação do DSC após essas etapas, reinicie o XBOX PC Toolbox e tente novamente.

​

Erro do OpenSSH: kex_exchange_identification: read: Connection reset

• Reinicie o dispositivo de destino.
• Verifique se o dispositivo está em um perfil de rede privada; caso contrário, o firewall pode bloquear a conexão.
• Verifique se há um arquivo known_hosts corrompido no seu dispositivo local.

​

A instalação do Microsoft PowerShell 7.5 pelo winget falha (0x8A150049)

• Solução alternativa: desinstale o PowerShell 7.6 (incluído com o Visual Studio 2026). A versão mais recente causa conflitos de instalação.

​

A execução do winget via SSH falha após o emparelhamento

• Solução alternativa: execute Repair-WinGetPackageManager no dispositivo de destino ou reinicie o dispositivo de destino.
• Causa: esse problema ocorre em conexões SSH.

​

A implantação do jogo falha em dispositivos portáteis

• Solução alternativa: ajuste as configurações de energia do dispositivo de destino para impedir que ele entre em suspensão durante a implantação. Verifique se o temporizador de suspensão do dispositivo está definido para uma duração maior ou desabilitado durante a implantação.
• Causa: o XBOX PC Toolbox não gerencia mais as configurações de energia do dispositivo via DSC. Em dispositivos portáteis com temporizadores de suspensão agressivos, o dispositivo entra em suspensão no meio da implantação, fazendo com que o wdRemote falhe.

​

O emparelhamento mostra sucesso no dispositivo de destino remoto, mas a conexão SSH falha no PC de desenvolvimento

Get-Service sshd

Restart-Service sshd

ssh -o IdentitiesOnly=yes -i "$env:USERPROFILE\.ssh\XboxPCDeviceManagerKey" -o PreferredAuthentications=publickey user@target-ip "echo SUCCESS"

• Se esse comando for bem-sucedido, o ssh-agent está armazenando em cache as chaves erradas. Siga as etapas abaixo para corrigir.
• Se esse comando falhar, o problema está no lado do dispositivo de destino remoto. Para diagnosticar mais, veja Como coletar logs do OpenSSH.

# Clear all cached keys
ssh-add -D

# Restart the agent service
Restart-Service ssh-agent

# Re-add only the correct key
ssh-add "$env:USERPROFILE\.ssh\XboxPCDeviceManagerKey"

# Verify only your key is loaded
ssh-add -l

# Test the connection
ssh -o PreferredAuthentications=publickey user@target-ip "echo SUCCESS"

​

Como coletar logs do OpenSSH

1. Abra o Bloco de Notas como administrador.
2. Abra o arquivo C:\ProgramData\ssh\sshd_config.

3. Encontre a seção que começa com # Logging e altere:
   # Logging
   #SyslogFacility AUTH
   #LogLevel INFO
   
   para:
   # Logging
   SyslogFacility LOCAL0
   LogLevel Debug3
   
4. Abra um terminal do PowerShell como administrador e reinicie o serviço SSH:
   net stop sshd
   net start sshd
   
5. Reproduza o problema no app XBOX PC Toolbox.
6. Colete os logs em C:\ProgramData\ssh\logs. Compacte a pasta em um arquivo .zip para compartilhar com a equipe de desenvolvimento.
7. Depois de coletar os logs, reverta as alterações feitas na etapa 3 (adicione # de volta ao início de cada linha) e reinicie o serviço SSH novamente usando a etapa 4.

​

Veja também

• Como usar o XBOX PC Remote Tools
• Guia de início rápido do XBOX PC Remote Tools
• Visão geral do XBOX PC Remote Tools