​

Preguntas frecuentes y guía de solución de problemas de las XBOX PC Remote Tools

​

Preguntas frecuentes

​

¿Cuál es la diferencia entre los tipos de dispositivo Fully Managed y Lightweight?

​

¿Dónde puedo encontrar el número de versión de la aplicación?

​

¿Cuáles son los problemas conocidos, las dependencias y las limitaciones?

​

Problemas conocidos

1. La configuración de PowerShell/DSC puede producir un error y XBOX PC Toolbox podría cerrarse inesperadamente durante la configuración.
   • Solución alternativa: consulta El aprovisionamiento de PowerShell y DSC produce un error durante la configuración.
2. Dispositivos de destino unidos a un dominio: solo se admite la autenticación basada en contraseña para las conexiones OpenSSH en modo Fully Managed (se prefiere la autenticación basada en claves, pero no está disponible). El aprovisionamiento Lightweight está disponible como alternativa para dispositivos unidos a un dominio.
   • Nota: este problema afecta a los dispositivos Windows Pro unidos a un dominio que usan el modo Fully Managed. El equipo está trabajando con los equipos de OpenSSH y Microsoft Entra ID para futuras mejoras.
3. Errores de comandos de WinGet (por ejemplo, winget search produce un error)
   • Solución alternativa: reinicia el dispositivo de destino. El equipo del producto está investigando este problema.
4. Rendimiento del depurador de Visual Studio: el XBOX PC Remote Debugger aún no está optimizado para el rendimiento. Es de esperar que los tiempos de depuración sean más lentos en comparación con la depuración local. Una versión futura mejorará el rendimiento del depurador.
5. El XBOX PC Remote Debugger puede dejar de responder después de varias iteraciones de depuración. Reinicia el dispositivo de destino después de aproximadamente 50 iteraciones.
   • Solución alternativa: reinicia el dispositivo de destino y, a continuación, reinicia la sesión del depurador.

​

Dependencias y limitaciones

• Ambos dispositivos necesitan acceso a Internet durante la configuración.
• Los dispositivos deben estar en la misma red local y poder hacer ping entre sí.
• La aplicación XBOX PC Toolbox solo está disponible en el sandbox RETAIL. Asegúrate de que los dispositivos estén en modo RETAIL para descargarla desde la Microsoft Store.
• Dispositivos compatibles: Windows 10 o Windows 11, ediciones Home o Pro.
• Se requiere acceso físico a ambos dispositivos durante la configuración.
• Se requiere acceso de administrador en ambos dispositivos para la configuración.
• Los dispositivos de destino unidos a Microsoft Entra ID solo se admiten mediante el aprovisionamiento Lightweight. Fully Managed no está disponible para dispositivos unidos a Entra. La aplicación lo detecta automáticamente y deshabilita la opción Fully Managed durante la configuración.

​

¿Desemparejar desde mi PC de desarrollo desconecta completamente el dispositivo?

​

¿Cómo encuentro la información de conexión del dispositivo?

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

​

¿Cómo verifico los cambios de configuración en los 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"

​

¿Cómo verifico y cambio el sandbox?

​

¿Cómo selecciono un adaptador de red específico para la configuración del canal seguro?

​

¿Cómo puedo notificar un problema?

• Versión del sistema operativo (compilación de Windows 10/11)
• Versión de PowerShell ($PSVersionTable) para problemas del módulo de PowerShell XBOX Device Management
• Configuración de red (Wi-Fi/Ethernet, corporativa/doméstica)
• Mensajes de error (texto exacto)
• Pasos para reproducir el problema
• Qué herramienta usaste (XBOX PC Toolbox, módulo de PowerShell XBOX Device Management, wdRemote o wdEndpoint)
• Versión preliminar

​

¿Cuál es la diferencia entre el módulo de PowerShell XBOX Device Management (XDM) y wdRemote/wdEndpoint?

• XDM: configura canales de comunicación seguros.
• wdRemote/wdEndpoint: implementa e inicia juegos a través de esos canales.

​

¿Necesito tanto XDM como wdRemote/wdEndpoint?

​

¿Por qué ejecutar wdEndpoint como administrador la primera vez?

​

¿Puedo implementar varios juegos en el mismo dispositivo de destino?

​

¿Qué ocurre si la conexión de red se interrumpe durante la implementación?

​

¿Está cifrada toda la comunicación?

​

¿Qué herramienta debo usar para cada tarea?

• XBOX PC Toolbox: úsala para aprovisionar y adquirir dispositivos de forma remota, configurar canales seguros, instalar dependencias y configurar dispositivos.
• Probar la conectividad: usa XBOX PC Toolbox antes de implementar juegos.
• Sesiones remotas: usa sesiones remotas habilitadas por XDM y la comunicación remota de PowerShell para ejecutar comandos en el dispositivo de destino.
• wdRemote/wdEndpoint: usa estas herramientas para implementar, probar y finalizar juegos.

​

¿Puedo usar estas herramientas con cualquier juego de Windows?

​

¿Qué puertos de red usan estas herramientas?

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

​

Guía de solución de problemas

​

El emparejamiento produce un error en un entorno de red corporativa

• Comprueba que ambos dispositivos sean visibles entre sí en la red. Los firewalls corporativos o la segmentación de la red pueden bloquear la comunicación entre dispositivos.
• Asegúrate de que los siguientes puertos estén abiertos entre los dispositivos: puerto 22 (OpenSSH) y puerto 4275 (herramientas de iteración remota).
• Desconéctate de cualquier VPN antes de intentar emparejar o conectar.
• Si tu organización requiere el registro de dispositivos, confirma que tu dispositivo está registrado de acuerdo con las directivas de TI.

​

Error al instalar las herramientas necesarias

• Solución alternativa: elimina los directorios de los módulos de %onedrive%/Documents/PowerShell/Modules/ e inténtalo de nuevo.
• Causa: OneDrive puede interferir con la instalación de módulos de PowerShell.

​

El aprovisionamiento de PowerShell y DSC produce un error durante la configuración

• Abre un terminal con permisos elevados y ejecuta:

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

• Si la configuración se bloquea al instalar DSC después de estos pasos, reinicia XBOX PC Toolbox e inténtalo de nuevo.

​

Error de OpenSSH: kex_exchange_identification: read: Connection reset

• Reinicia el dispositivo de destino.
• Asegúrate de que el dispositivo esté en un perfil de red privada; de lo contrario, el firewall podría bloquear la conexión.
• Comprueba si hay un archivo known_hosts dañado en tu dispositivo local.

​

La instalación de Microsoft PowerShell 7.5 con winget produce un error (0x8A150049)

• Solución alternativa: desinstala PowerShell 7.6 (incluido con Visual Studio 2026). La versión más reciente provoca conflictos de instalación.

​

La ejecución de winget mediante SSH produce un error después del emparejamiento

• Solución alternativa: ejecuta Repair-WinGetPackageManager en el dispositivo de destino o reinicia el dispositivo de destino.
• Causa: este problema se produce a través de conexiones SSH.

​

La implementación de juegos produce un error en dispositivos portátiles

• Solución alternativa: ajusta la configuración de energía del dispositivo de destino para evitar que entre en suspensión durante la implementación. Asegúrate de que el temporizador de suspensión del dispositivo esté establecido en una duración más larga o deshabilitado durante la implementación.
• Causa: XBOX PC Toolbox ya no administra la configuración de energía del dispositivo mediante DSC. En dispositivos portátiles con temporizadores de suspensión agresivos, el dispositivo entra en suspensión en mitad de la implementación, lo que provoca que wdRemote produzca un error.

​

El emparejamiento se muestra correctamente en el dispositivo de destino remoto, pero la conexión SSH produce un error en el PC de desarrollo

Get-Service sshd

Restart-Service sshd

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

• Si este comando se ejecuta correctamente, el ssh-agent está almacenando en caché claves incorrectas. Sigue los pasos que se indican a continuación para corregirlo.
• Si este comando produce un error, el problema está en el lado del dispositivo de destino remoto. Para seguir diagnosticando, consulta Cómo recopilar registros de 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"

​

Cómo recopilar registros de OpenSSH

1. Abre el Bloc de notas como administrador.
2. Abre el archivo C:\ProgramData\ssh\sshd_config.

3. Busca la sección que empieza por # Logging y cambia:
   # Logging
   #SyslogFacility AUTH
   #LogLevel INFO
   
   por:
   # Logging
   SyslogFacility LOCAL0
   LogLevel Debug3
   
4. Abre un terminal de PowerShell como administrador y reinicia el servicio SSH:
   net stop sshd
   net start sshd
   
5. Reproduce el problema en la aplicación XBOX PC Toolbox.
6. Recopila los registros de C:\ProgramData\ssh\logs. Comprime la carpeta en un archivo .zip para compartirla con el equipo de desarrollo.
7. Después de recopilar los registros, revierte los cambios realizados en el paso 3 (vuelve a agregar # al principio de cada línea) y reinicia de nuevo el servicio SSH mediante el paso 4.

​

Consulte también

• Cómo usar las XBOX PC Remote Tools
• Guía de inicio rápido de las XBOX PC Remote Tools
• Información general de las XBOX PC Remote Tools