> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cómo usar las XBOX PC Remote Tools

> Configura dispositivos, emparéjalos y usa las XBOX PC Remote Tools para iterar en dispositivos Windows remotos.

# Cómo usar las XBOX PC Remote Tools

<Info>
  La aplicación XBOX PC Toolbox está en versión preliminar. Descárgala desde la [Microsoft Store](https://aka.ms/toolboxinstaller) en Windows.
</Info>

## Configuración del dispositivo de desarrollo

1. En tu dispositivo, descarga e instala XBOX PC Toolbox desde la Microsoft Store en Windows.

2. Abre la aplicación. Selecciona **Set as development device** y, a continuación, selecciona **Continue**.

3. Selecciona **Install Tools** para agregar los componentes necesarios para tu entorno.

<Note>
  Al seleccionar **Install Tools**, aceptas los [términos del acuerdo](https://www.microsoft.com/en-us/servicesagreement). Para revisar los términos, selecciona el vínculo en la pantalla de instalación.
</Note>

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/remote-win-gamedev/xbtx_app_devpc_flow_prereq_install.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=dd6f0a51d15b67a5b9aac34d4da32a6a" alt="Pantalla de instalación de requisitos previos de la configuración de la aplicación XBOX PC Toolbox" width="1644" height="937" data-path="images/remote-win-gamedev/xbtx_app_devpc_flow_prereq_install.png" />

1. Después de la instalación, selecciona el adaptador de red para el canal seguro. Si tu sistema tiene un solo adaptador, la aplicación lo selecciona automáticamente.

2. Agrega una frase de contraseña segura para proteger tu clave SSH. Guarda la frase de contraseña de forma segura.

3. Selecciona **Confirm** para iniciar el proceso de configuración del dispositivo.

4. Cuando la configuración se complete, verás la pantalla del área de trabajo del dispositivo.

***

## Configuración del dispositivo de destino remoto

Sigue los mismos pasos que para el dispositivo de desarrollo, con estas diferencias:

1. En el paso 2, selecciona **Set as a remote target device** en lugar de dispositivo de desarrollo.

2. Selecciona un tipo de dispositivo:

   * **Fully Managed**: habilita la iteración remota y las capacidades de administración de dispositivos mediante SSH.
   * **Lightweight**: habilita los escenarios de iteración remota (implementar, iniciar y finalizar) mediante HTTPS/TLS sin necesidad de configurar SSH.

   Ambos modos usan comunicación cifrada.

   <img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/remote-win-gamedev/target-device-subtype.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=064995229626fd03a28e6d85c068a1c5" alt="Subtipos de dispositivo de destino" width="1059" height="904" data-path="images/remote-win-gamedev/target-device-subtype.png" />

3. En el paso 5, no necesitas crear claves SSH ni agregar una frase de contraseña en el dispositivo de destino remoto.

***

## Administración de complementos del dispositivo

Los complementos son componentes opcionales que habilitan flujos de trabajo de desarrollo que podrían no ser necesarios para todos los proyectos. Después de configurar tu dispositivo en XBOX PC Toolbox, estos complementos quedan disponibles.

Habilita el complemento Windows Graphics Tools si estás depurando o generando perfiles de gráficos DirectX o de la API de D3D. Windows Graphics Tools habilita la capa de depuración de D3D y la validación basada en GPU en tu dispositivo. Cuando está habilitado, puedes usar herramientas como PIX para ejecutar capturas de GPU, y se muestran los errores de validación de la API de D3D.

También puedes habilitar este complemento a través de la Configuración de Windows administrando las características opcionales. Sin embargo, el Toolbox proporciona este complemento para simplificar la configuración del dispositivo sin necesidad de salir de la aplicación.

Puedes habilitar o deshabilitar complementos en el área de trabajo de complementos seleccionando una única opción. Puedes aplicar complementos a tu PC de desarrollo y a los dispositivos Windows remotos.

<Note>
  Si tienes algún problema al deshabilitar un complemento, asegúrate de que tu dispositivo Windows esté actualizado y reinícialo. Si el problema persiste, notifícalo a través del Centro de opiniones.
</Note>

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/remote-win-gamedev/toolboxgraphicstools.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=c09bc8a312cb8845c3681ad14aba049a" alt="Pantalla de administración de complementos en XBOX PC Toolbox" width="2138" height="1176" data-path="images/remote-win-gamedev/toolboxgraphicstools.png" />

***

## Emparejamiento de los dispositivos

1. **En el dispositivo de destino remoto:** en el área de trabajo, selecciona **Pair device** para iniciar el emparejamiento.

   <img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/remote-win-gamedev/empty_devworkspace_tdev_pair.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=ba7a6221a4ddf76b53df4d936425cd81" alt="Emparejar este dispositivo" width="1428" height="241" data-path="images/remote-win-gamedev/empty_devworkspace_tdev_pair.png" />

2. **En el dispositivo de destino remoto:** selecciona **Start Pairing**. La aplicación genera un PIN y muestra los detalles de conexión. Anota estos detalles para la configuración y para probar la conexión.

   <img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/remote-win-gamedev/test_device_connection_details.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=e3952cbf8a375407e99ee37ddd9a8bd3" alt="Detalles de conexión del dispositivo remoto" width="1549" height="875" data-path="images/remote-win-gamedev/test_device_connection_details.png" />

<Note>
  Tienes dos minutos para introducir el PIN en el PC de desarrollo antes de que expire.
</Note>

1. **En el dispositivo de desarrollo:** en la pantalla del área de trabajo del dispositivo, selecciona **Pair device**. Esta acción abre la pantalla de selección del tipo de dispositivo, donde seleccionas **Fully Managed** o **Lightweight** para el dispositivo de destino remoto.

2. **En el dispositivo de desarrollo:** esta acción abre la pantalla de emparejamiento de un dispositivo nuevo, donde introduces la información de conexión que obtuviste del dispositivo de destino remoto. Introduce la dirección IP o el nombre del dispositivo, el PIN, el nombre de usuario y el alias. Selecciona **Pair device**.

   <img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/remote-win-gamedev/xbtx_app_devpc_pair_dev.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=210c8e89d60ab711f60106b5279bc34c" alt="Emparejamiento de un dispositivo nuevo" width="2365" height="1513" data-path="images/remote-win-gamedev/xbtx_app_devpc_pair_dev.png" />

3. **En el dispositivo de destino remoto:** cuando el emparejamiento se realice correctamente, selecciona **Return Home** para volver al área de trabajo. El dispositivo está listo para operaciones seguras Fully Managed u operaciones Lightweight.

   <img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/remote-win-gamedev/pair_success_hh.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=9cb32848201c415b2600061b4a989715" alt="Emparejamiento correcto" width="1920" height="1080" data-path="images/remote-win-gamedev/pair_success_hh.png" />

4. **En el dispositivo de desarrollo:** para finalizar la configuración de los dispositivos Fully Managed, acepta la huella digital de SSH. La aplicación abre un terminal y pregunta si quieres continuar. Escribe `yes` y presiona Entrar.

   <img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/remote-win-gamedev/ssh_fingerprint_confirm_screen.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=80d9772df23dee6dfa52a0711218972f" alt="Aceptar la huella digital de SSH" width="1481" height="244" data-path="images/remote-win-gamedev/ssh_fingerprint_confirm_screen.png" />

<Note>
  Después de conectarte, escribe `exit` y presiona Entrar para cerrar la ventana. Cerrar con el botón **X** podría causar problemas conocidos.
</Note>

1. **En el dispositivo de desarrollo:** cuando finalice la prueba de conexión, una pantalla de confirmación indica que los dispositivos están emparejados de forma segura. Selecciona **Return home** para ir a la pantalla del área de trabajo del dispositivo y ver todos los dispositivos de destino remotos emparejados.

<img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/remote-win-gamedev/devicewkspc-target_devices.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=5806f945ee992a4834d08f6358ba5410" alt="Dispositivos de destino remotos emparejados con la marca fully managed o lightweight" width="1440" height="800" data-path="images/remote-win-gamedev/devicewkspc-target_devices.png" />

***

## Desemparejamiento de dispositivos

Para administrar un dispositivo emparejado, selecciona el icono de engranaje en la tarjeta del dispositivo en el área de trabajo. Desde ahí, puedes:

* **Unpair device**: quita el dispositivo emparejado de tu área de trabajo.
* **Rename device**: cambia el nombre para mostrar del dispositivo emparejado.
* **Edit connection settings**: actualiza la dirección IP u otros detalles de conexión del dispositivo emparejado.

<Info>
  Desempareja desde el **dispositivo de destino remoto**. Cuando desemparejas desde el dispositivo de destino remoto, las claves SSH se quitan de ambos dispositivos, por lo que la desconexión es limpia. Si desemparejas desde el PC de desarrollo, el dispositivo solo se quita del área de trabajo local.
</Info>

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/remote-win-gamedev/unpair-hh.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=f000fd939a8612850f41b975ea6add8c" alt="Desemparejamiento desde el dispositivo de destino remoto" width="1800" height="1000" data-path="images/remote-win-gamedev/unpair-hh.png" />

***

## Uso de XBOX PC Device Manager (XDM)

XBOX PC Device Manager (XDM) es un módulo de PowerShell que se instala durante la configuración. Crea una comunicación segura y cifrada entre los PC de desarrollo y los dispositivos remotos. XDM administra la adquisición de dispositivos, la configuración de OpenSSH y la confianza, y habilita la ejecución remota de comandos con administración del estado del dispositivo.

### Inicio de una sesión interactiva

En tu PC de desarrollo, ve al área de trabajo del dispositivo en XBOX PC Toolbox. Busca la tarjeta del dispositivo al que quieres conectarte y selecciona **Connect**. Esta acción inicia una sesión interactiva con el dispositivo remoto mediante la comunicación remota de PowerShell en un terminal de línea de comandos. Los comandos que ejecutes aquí se ejecutan en el dispositivo remoto.

<img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/remote-win-gamedev/dev_ws_connect.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=01509288dc6f532334907110b8924b69" alt="Pantalla Connect del área de trabajo del dispositivo" width="810" height="488" data-path="images/remote-win-gamedev/dev_ws_connect.png" />

## Aprovisionamiento de las herramientas de iteración remota

Usa las herramientas de línea de comandos **wdRemote** y **wdEndpoint** para implementar de forma incremental, iniciar y finalizar juegos en dispositivos Windows remotos después de configurar una conexión segura mediante XBOX PC Toolbox. Ambas herramientas son ejecutables independientes que se instalan durante el emparejamiento.

* **wdRemote.exe**: se ejecuta en el PC de desarrollo y envía comandos.
* **wdEndpoint.exe**: se ejecuta en el dispositivo de destino remoto y ejecuta comandos.

***

### Uso de wdRemote

Abre un terminal de línea de comandos en tu PC de desarrollo para ejecutar comandos de `wdRemote`.

#### Implementar un juego

Cuando especifiques rutas de acceso para máquinas remotas, usa rutas relativas al directorio gameroot. El directorio raíz del juego es `C:\%ProgramData%\Microsoft GDK\wdEndpoint\gameroot` en el dispositivo de destino remoto.

```cmd theme={null}
# Syntax
wdRemote /action:deploy /device:<computername or ip address> /source:<source_directory> /destination:<destination_directory_under_gameroot>

# Example
wdRemote /action:deploy /device:mypc1 /source:c:\game /destination:gamedir
```

#### Iniciar un juego

```cmd theme={null}
# Syntax  
wdRemote /action:launch /device:<computername or ip address> /path:<remote_path_to_exe_within_gameroot>

# Example
wdRemote /action:launch /device:mypc1 /path:gamedir\game.exe
```

#### Finalizar un juego

```cmd theme={null}
# Syntax
wdRemote /action:terminate /device:<computername or ip address> /processid:<game_process_id>

# Example
wdRemote /action:terminate /device:mypc1 /processid:1234
```

### Envío de comentarios

En la barra de título de XBOX PC Toolbox, selecciona **Send Feedback**. A continuación, selecciona **Report a Problem**.

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xboxpctoolbox/feedback-icon.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=899b38220aba876e2f157f3c280152aa" alt="texto alternativo" width="1264" height="373" data-path="images/xboxpctoolbox/feedback-icon.png" />

Al notificar problemas, incluye:

* 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** que estás usando

## Consulte también

* [Herramienta de línea de comandos XBOX PC Remote (wdRemote.exe)](/tools/tools-pc/commandlinetools/gr-wdRemote)
* [Punto de conexión de escucha XBOX PC Remote (wdEndpoint.exe)](/tools/tools-pc/commandlinetools/gr-wdEndpoint)
* [Notas de la versión de las XBOX PC Remote Tools](/tools/tools-pc/xbox-pc-remote-tools/release-notes/2603)
* [Preguntas frecuentes y guía de solución de problemas de las XBOX PC Remote Tools](/tools/tools-pc/xbox-pc-remote-tools/faq)

## Referencia de API

<Card title="Referencia de la API XBOX PC Remote Iteration" icon="code" href="/reference/remoting/remoteiteration_members">
  Usa la API XBOX PC Remote Iteration para automatizar la implementación remota, el inicio y la administración de procesos.
</Card>


## Related topics

- [Preguntas frecuentes y guía de solución de problemas de las XBOX PC Remote Tools](/es/tools/tools-pc/xbox-pc-remote-tools/faq.md)
- [XBOX PC Remote Tools: notas de la versión de marzo de 2026 (2603)](/es/tools/tools-pc/xbox-pc-remote-tools/release-notes/2603.md)
- [XBOX PC Remote Tools](/es/tools/tools-pc/xbox-pc-remote-tools/index.md)
- [Guía de inicio rápido de las XBOX PC Remote Tools](/es/tools/tools-pc/xbox-pc-remote-tools/quickstart.md)
- [XBOX PC Remote Tools: notas de la versión de mayo de 2026 (2605)](/es/tools/tools-pc/xbox-pc-remote-tools/release-notes/2605.md)