XBOX PC Remote (wdRemote.exe)

L’application XBOX PC Toolbox est en préversion. Téléchargez-la depuis le Microsoft Store sur Windows.

XBOX PC Remote (wdRemote.exe) est un outil en ligne de commande permettant de connecter de manière sécurisée un PC de développement à un appareil Windows distant. Il prend en charge l’appairage par code PIN, le transfert de fichiers bidirectionnel, la suppression de fichiers à distance, le déploiement et la gestion du cycle de vie des jeux, ainsi que l’exécution d’outils à distance. wdRemote s’exécute sur un PC de développement et communique avec une instance de wdEndpoint.exe exécutée sur l’appareil distant. Consultez la vue d’ensemble de XBOX PC Remote Tools pour une description du rôle de wdRemote et wdEndpoint dans la suite d’outils de développement à distance pour appareils Windows. Utilisez XBOX PC Toolbox ou WinGet pour installer wdRemote sur votre PC de développement. winget install Microsoft.Gaming.RemoteIterationClient Utilisez wdRemote pour exécuter les commandes répertoriées dans le tableau suivant.

Commande	Description
wdRemote /action:pair	Établit une connexion sécurisée et approuvée entre un PC de développement et l’appareil distant par appairage par code PIN.
wdRemote /action:purgekeys	Supprime toutes les clés de chiffrement et tous les appairages d’appareils d’un PC de développement.
wdRemote /action:version	Affiche la version de wdRemote.exe.
wdRemote /action:status	Affiche l’état de la connexion entre le PC de développement et l’appareil cible.
wdRemote /action:deploy	Déploie un jeu d’un PC de développement vers un appareil Windows distant.
wdRemote /action:launch	Lance un jeu sur un appareil Windows distant.
wdRemote /action:resume	Reprend l’exécution d’un jeu lancé à l’état suspendu sur un appareil Windows distant.
wdRemote /action:terminate	Arrête le jeu, le travail d’outil ou le processus spécifié sur un appareil Windows distant.
wdRemote /action:copy	Copie des fichiers du PC de développement vers un appareil Windows distant.
wdRemote /action:copyfrom	Copie des fichiers d’un appareil Windows distant vers le PC de développement.
wdRemote /action:delete	Supprime un fichier ou le contenu d’un répertoire sur un appareil Windows distant.
wdRemote /action:run	Exécute un exécutable sur un appareil Windows distant.

Appairage d’appareils Windows distants et gestion des clés de sécurité

wdRemote /action:pair

Cette commande établit une connexion sécurisée et approuvée entre un PC de développement et l’appareil distant par appairage par code PIN. wdEndpoint, exécuté sur l’appareil distant, génère le code PIN. wdRemote /action:pair /device:HostName | IP Address /pin:pin number [/sshKey:filename]

Option	Description
/action:pair	Indique que wdRemote doit effectuer une opération d’appairage par code PIN.
/device:	Adresse IP ou nom d’hôte de l’appareil distant.
/pin:	Code PIN généré par une instance de wdEndpoint exécutée sur l’appareil distant.
/sshKey:	Clé SSH facultative à installer sur l’appareil distant. Cette clé peut servir à établir une connexion SSH entre le PC de développement et l’appareil distant.

Exemple :

// 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: <example-device-id>
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: <example-pin>

// Specify the result PIN to the pairing /action to wdRemote on the development PC
c:>wdRemote /action:pair /device:example-device /pin:<example-pin>

Successfully paired.
Client: <example-client-id>
Device: <example-device-id>

Revenir en haut de cette rubrique.

wdRemote /action:purgekeys

Tout le trafic entre wdRemote et wdEndpoint est chiffré. wdRemote crée automatiquement les clés de chiffrement et les certificats requis la première fois qu’il doit se connecter à un appareil distant. Ces clés sont également utilisées dans le processus d’appairage. Cette action supprime toutes les clés et tous les appairages d’appareils d’un PC de développement. wdRemote /action:purgekeys Revenir en haut de cette rubrique.

Informations d’état et de version

wdRemote /action:version

Affiche la version de wdRemote.exe. wdRemote /action:version Revenir en haut de cette rubrique.

wdRemote /action:status

Affiche l’état de la connexion entre le PC de développement et l’appareil cible. wdRemote /action:pair vérifie tous les appairages d’appareils et s’assure que le chiffrement est actif. wdRemote /action:status /device:HostName | IP Address

Option	Description
/action:status	Indique que `wdRemote` doit afficher l’état de la connexion entre le PC de développement et l’appareil identifié par l’argument `/device:`
/device:	Adresse IP ou nom d’hôte de l’appareil distant.

Revenir en haut de cette rubrique.

Déployer, lancer et arrêter des applications

wdRemote /action:deploy

Déploie un jeu d’un PC de développement vers l’appareil cible spécifié par l’argument /device:. Tous les déploiements sont incrémentiels : seuls les fichiers modifiés depuis le dernier déploiement sont transférés vers l’appareil cible. Les jeux sont stockés sur l’appareil cible dans un répertoire appelé Common Root. Par défaut, la Common Root est %ProgramData%\Microsoft GDK\gameroot. Les chemins de destination passés à wdRemote sont relatifs à la Common Root, sauf si vous spécifiez un chemin absolu, auquel cas la Common Root est ignorée. Vous pouvez modifier l’emplacement de la Common Root par défaut et ajouter d’autres Common Roots en créant un fichier nommé wdEndpoint.json et en le plaçant dans %ProgramData%\Microsoft GDK\wdEndpoint\ sur l’appareil cible. wdEndpoint.json contient une liste de Common Roots au format suivant.

{
  root:<absolute file path>,
  alias:<name>,
  default:true|false
}

La spécification de default est facultative. Si plusieurs valeurs par défaut sont spécifiées, la première de la liste devient la valeur par défaut. Si aucune racine n’est marquée comme valeur par défaut, la première de la liste devient la valeur par défaut. L’exemple de fichier wdEndpoint.json suivant définit deux Common Roots : une racine par défaut dans c:\developmentbuilds et une autre racine dans d:\releasedbuilds.

{
    "gameRoots": [
        {
            "root": "c:\\developmentbuilds",
            "alias": "primary",
            "default": true
        },
        {
            "root": "d:\\releasedbuilds",
            "alias": "released"
        }
    ]
}

wdRemote /action:deploy /device:<remote device> /source:<source directory> /destination:<absolute or common root relative destination directory> [/root:<common root alias>] [/attributes:<-AHSR>]

Option	Description
/action:deploy	Indique que `wdRemote` doit effectuer une action de déploiement.
/device:	Adresse IP ou nom d’hôte de l’appareil distant.
/source:	Répertoire du PC de développement qui contient le jeu à déployer.
/destination:	Les chemins de destination relatifs sont résolus sous la Common Root sélectionnée. Si un chemin absolu est spécifié, la Common Root est ignorée.
/root:	Alias facultatif de Common Root. S’il n’est pas spécifié, la Common Root par défaut est utilisée.
/attributes:	Inclut ou exclut éventuellement des fichiers et des répertoires selon leurs attributs de fichier.

L’option /attributes: prend en charge les lettres suivantes.

Lettre	Attribut de fichier
`A`	Archive
`H`	Caché
`R`	Lecture seule
`S`	Système

Les lettres situées avant - sont incluses. Les lettres situées après - sont exclues. Exemples

// 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:example-device /source:c:\gamesource\x64\Debug /destination:Daily

// Deploys the contents of \\example-server\builds\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:example-device /source:\\example-server\builds\buildoutput /destination:october2025 /root:released

// Deploys everything except hidden files and directories.
c:\>wdRemote /action:deploy /device:example-device /source:C:\game /destination:game1 /attributes:-H

Revenir en haut de cette rubrique.

wdRemote /action:launch

Lance un jeu sur l’appareil distant spécifié par l’argument /device:. L’ID de processus du jeu lancé est affiché en sortie. wdRemote garantit qu’un seul jeu à la fois s’exécute sur l’appareil distant. Si un jeu est déjà en cours d’exécution sur l’appareil distant lorsque vous exécutez wdRemote /action:launch, il est arrêté avant le démarrage du nouveau jeu.

wdRemote /action:launch /device:<remote device> /path:<absolute or Common Root-relative executable path> [/root:<Common Root alias>] [/args:"<arguments>"] [/suspend]

Option	Description
/action:launch	Indique que wdRemote doit effectuer une action de lancement.
/device:	Adresse IP ou nom d’hôte de l’appareil distant.
/path:	Chemin d’accès à l’exécutable à lancer. Les chemins relatifs sont résolus sous la Common Root. Si un chemin absolu est spécifié, la Common Root est ignorée.
/args:	Liste d’arguments à passer à l’exécutable.
/root:	Alias facultatif de Common Root. S’il n’est pas spécifié, la Common Root par défaut est utilisée.
/suspend:	Indicateur facultatif qui lance le jeu à l’état suspendu. Utilisez `wdRemote /action:resume` pour reprendre l’exécution d’un jeu lancé avec `/suspend`.

Exemples

// Launches a game in the default Common Root, passing a command line argument to the game
c:\>wdRemote /action:launch /device:example-device /path:Daily\Game.exe /args:"-level 2"

// Launches a game in a suspended state
c:\>wdRemote /action:launch /device:example-device /path:Daily\Game.exe /suspend

Revenir en haut de cette rubrique.

wdRemote /action:resume

Reprend l’exécution, sur l’appareil distant, d’un jeu lancé à l’état suspendu à l’aide de wdRemote /action:launch avec l’indicateur /suspend. wdRemote /action:resume /device:HostName | IP Address

Option	Description
/action:resume	Indique que `wdRemote` doit effectuer une action de reprise.
/device:	Adresse IP ou nom d’hôte de l’appareil distant.

Exemples

c:\>wdRemote /action:resume /device:example-device

Revenir en haut de cette rubrique.

wdRemote /action:terminate

Arrête le jeu distant, le travail d’outil distant ou le processus distant spécifié.

wdRemote /action:terminate /device:<remote device>
wdRemote /action:terminate /device:<remote device> /tool[:<pid>]

Forme	Comportement
Aucun argument `/tool`	Arrête le jeu distant.
`/tool`	Arrête le travail d’outil distant.
`/tool:pid`	Tente d’arrêter le processus ayant l’ID de processus spécifié.

Exemples

// Terminates the remote game.
c:\>wdRemote /action:terminate /device:example-device

// Terminates the remote tool job.
c:\>wdRemote /action:terminate /device:example-device /tool

// Attempts to terminate the specified process.
c:\>wdRemote /action:terminate /device:example-device /tool:1234

Revenir en haut de cette rubrique.

Copier et supprimer des fichiers

wdRemote /action:copy

Copie des fichiers du PC de développement vers un appareil Windows distant.

wdRemote /action:copy /device:HostName | IP Address /source:source directory /destination:remote directory [/root:gameRoot alias]

Option	Description
/action:copy	Indique que `wdRemote` doit effectuer une opération de copie.
/device:	Adresse IP ou nom d’hôte de l’appareil Windows distant.
/source:	Répertoire source sur le PC de développement.
/destination:	Répertoire de destination sur l’appareil Windows distant.
/root:	Alias facultatif de Common Root utilisé pour résoudre un chemin de destination relatif. S’il est omis pour un chemin relatif, la Common Root par défaut est utilisée. Les Common Roots sont ignorées pour les chemins de destination absolus.

Exemple

c:\>wdRemote /action:copy /device:example-device /source:C:\game /destination:game1

wdRemote /action:copyfrom

Copie des fichiers d’un appareil Windows distant vers le PC de développement. /source est le chemin distant et /destination le chemin local. /root résout un chemin source distant relatif et est ignoré lorsque /source est absolu.

wdRemote /action:copyfrom /device:HostName | IP Address /source:remote source directory /destination:local destination directory [/root:gameRoot alias]

Option	Description
/action:copyfrom	Indique que `wdRemote` doit effectuer une opération de copie depuis l’appareil.
/device:	Adresse IP ou nom d’hôte de l’appareil Windows distant.
/source:	Répertoire source sur l’appareil Windows distant.
/destination:	Répertoire de destination sur le PC de développement.
/root:	Alias facultatif de Common Root utilisé pour résoudre un chemin source distant relatif.

Exemple

c:\>wdRemote /action:copyfrom /device:example-device /source:game1 /destination:C:\local_copy

wdRemote /action:delete

Tente de supprimer un fichier ou le contenu sélectionné d’un répertoire sur un appareil Windows distant. La suppression de répertoire est effectuée au mieux. Le journal du point de terminaison enregistre le nombre d’éléments supprimés et le nombre d’échecs, mais pas les chemins de fichiers individuels.

wdRemote /action:delete /device:HostName | IP Address /path:remote directory or file [/root:gameRoot alias] [/include:pattern] [/exclude:pattern] [/excludedir:pattern] [/attributes:<-AHSR>] [/deleteroot]

Option	Description
/action:delete	Indique que `wdRemote` doit effectuer une opération de suppression.
/device:	Adresse IP ou nom d’hôte de l’appareil Windows distant.
/path:	Répertoire ou fichier distant à supprimer.
/root:	Alias facultatif de Common Root utilisé pour résoudre un chemin distant relatif.
/include:	Inclut les fichiers correspondant au modèle. Les caractères génériques `*` et `?` sont pris en charge.
/exclude:	Exclut les fichiers correspondant au modèle. Les caractères génériques `*` et `?` sont pris en charge. L’exclusion est prioritaire sur l’inclusion.
/excludedir:	Exclut les répertoires dont le nom correspond au modèle. Les caractères génériques `*` et `?` sont pris en charge.
/attributes:	Inclut ou exclut des fichiers et des répertoires selon les attributs Archive, Caché, Lecture seule et Système. L’exclusion d’un attribut exclut également les répertoires qui le possèdent, ainsi que tout leur contenu.
/deleteroot	Tente de supprimer le répertoire spécifié par `/path` après la suppression de son contenu. Le répertoire n’est supprimé que s’il est vide. Indépendamment de cette option, l’opération tente de supprimer les sous-répertoires vides qui passent les filtres de répertoire.

La suppression peut suivre les jonctions de répertoires et les liens symboliques de répertoires situés sous /path, et supprimer des fichiers correspondants en dehors de ce répertoire. La commande peut tout de même signaler une réussite ; aucun résultat par élément ni aucune opération d’annulation ne sont fournis. Assurez-vous que /path n’est pas lui-même un répertoire lié, et utilisez /excludedir pour exclure par leur nom les sous-répertoires liés connus.

Lorsque /path identifie un seul fichier, les options de recherche et /deleteroot sont ignorées. Exemples

c:\>wdRemote /action:delete /device:example-device /path:game1
c:\>wdRemote /action:delete /device:example-device /path:game1 /exclude:"*.pdb" /excludedir:"logs"
c:\>wdRemote /action:delete /device:example-device /path:game1 /deleteroot
c:\>wdRemote /action:delete /device:example-device /path:game1\readme.txt

Exécuter des outils à distance

wdRemote /action:run

Exécute un exécutable sur un appareil Windows distant.

wdRemote /action:run /device:HostName | IP Address /path:absolute executable path [/args:"arguments"] [/waitForExit] [/streamOutput] [/asAdmin]

Option	Description
/action:run	Indique que `wdRemote` doit exécuter un exécutable.
/device:	Adresse IP ou nom d’hôte de l’appareil Windows distant.
/path:	Chemin d’accès absolu à l’exécutable sur l’appareil Windows distant.
/args:	Arguments passés à l’exécutable.
/waitForExit	Attend la fin de l’exécutable.
/streamOutput	Diffuse la sortie standard et l’erreur standard jusqu’à la fin de l’exécutable.
/asAdmin	Exécute l’exécutable en tant qu’administrateur.

/waitForExit ne peut pas être combiné avec /streamOutput. /asAdmin ne peut pas être combiné avec /streamOutput. Sans /waitForExit ni /streamOutput, la commande indique l’ID de processus et l’ID de thread lancés. Avec /waitForExit ou /streamOutput, wdRemote.exe renvoie le code de sortie du processus distant. Exemples

c:\>wdRemote /action:run /device:example-device /path:C:\tools\mytool.exe
c:\>wdRemote /action:run /device:example-device /path:C:\tools\mytool.exe /args:"-arg1 -arg2" /waitForExit
c:\>wdRemote /action:run /device:example-device /path:C:\tools\mytool.exe /args:"-arg1 -arg2" /streamOutput
c:\>wdRemote /action:run /device:example-device /path:C:\tools\mytool.exe /asAdmin

Ressources supplémentaires

wdEndpoint XBOX PC Remote Tools

​XBOX PC Remote (wdRemote.exe)

​Appairage d’appareils Windows distants et gestion des clés de sécurité

​wdRemote /action:pair

​wdRemote /action:purgekeys

​Informations d’état et de version

​wdRemote /action:version

​wdRemote /action:status

​Déployer, lancer et arrêter des applications

​wdRemote /action:deploy

​wdRemote /action:launch

​wdRemote /action:resume

​wdRemote /action:terminate

​Copier et supprimer des fichiers

​wdRemote /action:copy

​wdRemote /action:copyfrom

​wdRemote /action:delete

​Exécuter des outils à distance

​wdRemote /action:run

​Ressources supplémentaires

XBOX PC Remote (wdRemote.exe)

Appairage d’appareils Windows distants et gestion des clés de sécurité

wdRemote /action:pair

wdRemote /action:purgekeys

Informations d’état et de version

wdRemote /action:version

wdRemote /action:status

Déployer, lancer et arrêter des applications

wdRemote /action:deploy

wdRemote /action:launch

wdRemote /action:resume

wdRemote /action:terminate

Copier et supprimer des fichiers

wdRemote /action:copy

wdRemote /action:copyfrom

wdRemote /action:delete

Exécuter des outils à distance

wdRemote /action:run

Ressources supplémentaires