> ## 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. # XBOX PC Remote (wdRemote.exe) > XBOX PC Remote (wdRemote.exe) La aplicación XBOX PC Toolbox está en versión preliminar. Descárguela desde el [Microsoft Store](https://aka.ms/toolboxinstaller) en Windows. XBOX PC Remote (wdRemote.exe) es una herramienta de línea de comandos que habilita dos flujos de trabajo necesarios para compilar juegos en dispositivos Windows remotos. Use estos dos comandos para: * Establecer una conexión segura y de confianza entre un equipo de desarrollo y un dispositivo remoto mediante el emparejamiento por PIN. * Implementar, iniciar y finalizar juegos en un dispositivo Windows remoto. `wdRemote` se ejecuta en un equipo de desarrollo y se comunica con una instancia de [wdEndpoint.exe](/tools/tools-pc/commandlinetools/gr-wdEndpoint) que se ejecuta en el dispositivo remoto. Consulte la [Información general sobre las herramientas de XBOX PC Remote](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/overviews/remote-win-gamedev) para obtener una descripción del papel que desempeñan `wdRemote` y `wdEndpoint` en el conjunto de herramientas de desarrollo remoto para dispositivos Windows. Use [XBOX PC Toolbox](/tools/tools-pc/xboxpctoolbox/xboxpctoolbox) o WinGet para instalar `wdRemote` en el equipo de desarrollo. `winget install Microsoft.Gaming.RemoteIterationClient` Use `wdRemote` para ejecutar los comandos que se enumeran en la tabla siguiente. | Comando | Descripción | | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | [wdRemote /action:pair](#wdRemote_pair) | Establece una conexión segura y de confianza entre un equipo de desarrollo y el dispositivo remoto mediante el emparejamiento por PIN. | | [wdRemote /action:purgekeys](#wdRemote_purgekeys) | Quita todas las claves de cifrado y los emparejamientos de dispositivos de un equipo de desarrollo | | [wdRemote /action:version](#wdRemote_version) | Muestra la versión de wdRemote.exe. | | [wdRemote /action:status](#wdRemote_status) | Muestra el estado de la conexión entre el equipo de desarrollo y el dispositivo de destino. | | [wdRemote /action:deploy](#wdRemote_deploy) | Implementa un juego desde un equipo de desarrollo en un dispositivo Windows remoto. | | [wdRemote /action:launch](#wdRemote_launch) | Inicia un juego en un dispositivo Windows remoto. | | [wdRemote /action:resume](#wdRemote_resume) | Reanuda un juego en un dispositivo Windows remoto que se inició en estado suspendido. | | [wdRemote /action:terminate](#wdRemote_terminate) | Finaliza un juego que se está ejecutando en un dispositivo Windows remoto. | ## Emparejamiento de dispositivos Windows remotos y administración de claves de seguridad ### wdRemote /action:pair Este comando establece una conexión segura y de confianza entre un equipo de desarrollo y el dispositivo remoto mediante el emparejamiento por PIN. [wdEndpoint](/tools/tools-pc/commandlinetools/gr-wdEndpoint), que se ejecuta en el dispositivo remoto, genera el PIN. `wdRemote /action:pair /device:HostName | IP Address /pin:pin number` *\[/sshKey:filename]* | Opción | Descripción | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | /action:pair | Indica que wdRemote debe realizar una operación de emparejamiento por PIN. | | /device: | La dirección IP o el nombre de host del dispositivo remoto. | | /pin: | El PIN generado por una instancia de [wdEndpoint](/tools/tools-pc/commandlinetools/gr-wdEndpoint) que se ejecuta en el dispositivo remoto. | | /sshKey: | Una clave ssh opcional para instalar en el dispositivo remoto. Esta clave puede usarse para establecer una conexión ssh entre el equipo de desarrollo y el dispositivo remoto. | Ejemplo: ``` // Start the pairing process by obtaining a pin using `wdEndpoint /pair` on the remote device. `wdEndpoint /pair` must be executed from a command prompt with Administrator privileges c:>wdEndpoint /pair wdEndpoint version: 1.0.0.0 No configuration found at 'C:\ProgramData\Microsoft GDK\wdEndpoint\wdEndpoint.json', using defaults. Overriding security mode for pairing. Device ID: 29aab0e953b95099388b169861940a7501c7c7be Security Mode: Private Common Roots: (Default) C:\ProgramData\Microsoft GDK\gameroot Server startup. Listening for requests on: https://+:4275/gamingTransport/. Entered exclusive pairing mode for 120 seconds. PIN: q87p7w // Specify the result PIN to the pairing /action to wdRemote on the desktop PC c:>wdRemote /action:pair /device:myROGAllyX /pin:q87p7w Successfully paired. Client: a701ed911d794154737a1ed2cfe29e292d532561 Device: 231d6063b48cfc136f8ebdcad0a472edc7a27527 ``` [Volver al principio de este tema.](/tools/tools-pc/commandlinetools/gr-wdRemote) ### wdRemote /action:purgekeys Todo el tráfico entre `wdRemote` y [wdEndpoint](/tools/tools-pc/commandlinetools/gr-wdEndpoint) está cifrado. `wdRemote` crea automáticamente las claves de cifrado y los certificados necesarios la primera vez que se le pide conectarse a un dispositivo remoto. Estas claves también se usan en el proceso de emparejamiento. `wdRemote /action:purgekeys` quita todas las claves y los emparejamientos de dispositivos de un equipo de desarrollo. `wdRemote /action:purgekeys` [Volver al principio de este tema.](/tools/tools-pc/commandlinetools/gr-wdRemote) ## Información de estado y versiones ### wdRemote /action:version Muestra la versión de wdRemote.exe. `wdRemote /action:version` [Volver al principio de este tema.](/tools/tools-pc/commandlinetools/gr-wdRemote) ### wdRemote /action:status Muestra el estado de la conexión entre el equipo de desarrollo y el dispositivo de destino. `wdRemote /action:pair` comprueba todos los emparejamientos de dispositivos y verifica que el cifrado esté en vigor. `wdRemote /action:status /device:HostName | IP Address` | Opción | Descripción | | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | /action:status | Indica que `wdRemote` debe mostrar el estado de la conexión entre el equipo de desarrollo y el dispositivo identificado por el argumento `/device:` | | /device: | La dirección IP o el nombre de host del dispositivo remoto. | [Volver al principio de este tema.](/tools/tools-pc/commandlinetools/gr-wdRemote) ## Implementar, iniciar y finalizar aplicaciones ### wdRemote /action:deploy Implementa un juego desde un equipo de desarrollo en el dispositivo de destino especificado por el argumento `/device:`. Todas las implementaciones son incrementales, lo que significa que solo los archivos que han cambiado desde la última implementación se transfieren al dispositivo de destino. Los juegos se almacenan en el dispositivo de destino en un directorio denominado *Common Root*. De forma predeterminada, el Common Root es `%ProgramData%\Microsoft GDK\gameroot`. Las rutas de acceso de destino que se pasan a `wdRemote` son relativas al Common Root a menos que especifique una ruta de acceso absoluta, en cuyo caso se omite el Common Root. La ubicación del Common Root predeterminado se puede cambiar, y se pueden agregar más Common Roots, creando un archivo denominado `wdEndpoint.json` y colocándolo en `%ProgramData%\Microsoft GDK\wdEndpoint\` en el dispositivo de destino. `wdEndpoint.json` contiene una lista de Common Roots con el formato siguiente. ```json theme={null} { root:, alias:, default:true|false } ``` Especificar *default* es opcional. Si se especifican varios valores predeterminados, el primero de la lista se convierte en el predeterminado. Si ninguna raíz está marcada como predeterminada, la primera de la lista se convertirá en la predeterminada. El siguiente ejemplo de `wdEndpoint.json` define dos Common Roots: una raíz predeterminada en `c:\developmentbuilds` y otra raíz en `d:\releasedbuilds`. ```json theme={null} { "gameRoots": [ { "root": "c:\\developmentbuilds", "alias": "primary", "default": true }, { "root": "d:\\releasedbuilds", "alias": "released" } ] } ``` `wdRemote /action:deploy /device:HostName | IP Address /source:directory /destination:folder under gameRoot [/root:gameRoot alias]` | Opción | Descripción | | -------------- | ----------------------------------------------------------------------------------------------------------------------- | | /action:deploy | Indica que `wdRemote` debe realizar una acción de implementación. | | /device: | La dirección IP o el nombre de host del dispositivo remoto. | | /source: | El directorio del equipo de desarrollo que contiene el juego que se va a implementar. | | /destination: | El directorio del dispositivo de destino donde se va a implementar el juego. Esta dirección es relativa al Common Root. | | /root: | Un alias opcional de Common Root. Si no se especifica, se usa el Common Root predeterminado. | Ejemplos ``` // Deploys the contents of c:\gamesource\x64\Debug to a directory named Daily under the default Common Root. Using the example config file above, the game // will be deployed to c:\developmentbuilds\Daily on the target device. c:\>wdRemote /action:deploy /device:myROGAllyX /source:c:\gamesource\x64\Debug /destination:Daily // Deploys the contents of \\releases\october2025\buildoutput to a directory named october2025 under the Common Root at d:\releasedbuilds. Using the example config file above, // the game will be deployed to d:\releasedbuilds\october2025 on the target device. c:\>wdRemote /action:deploy /device:myROGAllyX /source:\\releases\october2025\buildoutput /destination:october2025 ``` [Volver al principio de este tema.](/tools/tools-pc/commandlinetools/gr-wdRemote) ### wdRemote /action:launch Inicia un juego en el dispositivo remoto especificado por el argumento `/device:`. El identificador de proceso del juego que se inició se muestra como salida. `wdRemote` garantiza que solo se ejecute un juego a la vez en el dispositivo remoto. Si ya se está ejecutando un juego en el dispositivo remoto cuando se ejecuta `wdRemote /action:launch`, el juego en ejecución se finaliza antes de que se inicie el nuevo juego. `wdRemote /action:launch /device:HostName | IP Address /path:path to exe in Common Root [/args:list of arguments] [/root:gameRoot alias] [/suspend]` | Opción | Descripción | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | /action:launch | Indica que wdRemote debe realizar una acción de inicio. | | /device: | La dirección IP o el nombre de host del dispositivo remoto. | | /path: | La ruta de acceso al ejecutable que se va a iniciar. Las rutas de acceso relativas se resuelven bajo el Common Root. Si se especifica una ruta de acceso absoluta, se omite el Common Root. | | /args: | Una lista de argumentos que se pasan al ejecutable. | | /root: | Un alias opcional de Common Root. Si no se especifica, se usa el Common Root predeterminado. | | /suspend: | Una marca opcional que inicia el juego en estado suspendido. Use `wdRemote /action:resume` para reanudar un juego que se inició con `/suspend`. | Ejemplos ``` // Launches a game in the default Common Root, passing a command line argument to the game c:\>wdRemote /action:launch /device:myROGAllyX /path:Daily\Game.exe /args:"-level 2" // Launches a game in a suspended state c:\>wdRemote /action:launch /device:myROGAllyX /path:Daily\Game.exe /suspend ``` [Volver al principio de este tema.](/tools/tools-pc/commandlinetools/gr-wdRemote) ### wdRemote /action:resume Reanuda un juego en el dispositivo remoto que se inició en estado suspendido mediante `wdRemote /action:launch` con la marca `/suspend`. `wdRemote /action:resume /device:HostName | IP Address` | Opción | Descripción | | -------------- | -------------------------------------------------------------- | | /action:resume | Indica que `wdRemote` debe realizar una acción de reanudación. | | /device: | La dirección IP o el nombre de host del dispositivo remoto. | Ejemplos ``` c:\>wdRemote /action:resume /device:myROGAllyX ``` [Volver al principio de este tema.](/tools/tools-pc/commandlinetools/gr-wdRemote) ### wdRemote /action:terminate Finaliza el juego que se está ejecutando en un dispositivo remoto. `wdRemote /action:terminate /device:HostName | IP Address [/processid:id]` | Opción | Descripción | | ----------------- | --------------------------------------------------------------- | | /action:terminate | Indica que `wdRemote` debe realizar una acción de finalización. | | /device: | La dirección IP o el nombre de host del dispositivo remoto. | | /processid: | El identificador del proceso que se va a finalizar. | [Volver al principio de este tema.](/tools/tools-pc/commandlinetools/gr-wdRemote) ## Consulte también [wdEndpoint](/tools/tools-pc/commandlinetools/gr-wdEndpoint) [Herramientas de XBOX PC Remote](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/overviews/remote-gamedev-tools) ## Related topics - [Cómo usar las XBOX PC Remote Tools](/es/tools/tools-pc/xbox-pc-remote-tools/how-to-use-tools.md) - [Herramientas de línea de comandos para el desarrollo en PC](/es/tools/tools-pc/commandlinetools/gr-commandlinetools-toc.md) - [Commandlinetools](/es/tools/tools-pc/commandlinetools/index.md) - [Punto de conexión de escucha de XBOX PC Remote (wdEndpoint.exe)](/es/tools/tools-pc/commandlinetools/gr-wdEndpoint.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)