La aplicación XBOX PC Toolbox está en versión preliminar. Descárguela desde el Microsoft Store en Windows.
- 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 que se ejecuta en el dispositivo remoto. Consulte la Información general sobre las herramientas de XBOX PC Remote 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 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.
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, que se ejecuta en el dispositivo remoto, genera el PIN.wdRemote /action:pair /device:HostName | IP Address /pin:pin number [/sshKey:filename]
Ejemplo:
wdRemote /action:purgekeys
Todo el tráfico entrewdRemote y 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.
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.
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
Volver al principio de este tema.
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.
wdEndpoint.json define dos Common Roots: una raíz predeterminada en c:\developmentbuilds y otra raíz en d:\releasedbuilds.
wdRemote /action:deploy /device:HostName | IP Address /source:directory /destination:folder under gameRoot [/root:gameRoot alias]
Ejemplos
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]
Ejemplos
wdRemote /action:resume
Reanuda un juego en el dispositivo remoto que se inició en estado suspendido mediantewdRemote /action:launch con la marca /suspend.
wdRemote /action:resume /device:HostName | IP Address
Ejemplos
wdRemote /action:terminate
Finaliza el juego que se está ejecutando en un dispositivo remoto.wdRemote /action:terminate /device:HostName | IP Address [/processid:id]
Volver al principio de este tema.
