> ## 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)

# XBOX PC Remote (wdRemote.exe)

<Info>
  L'application XBOX PC Toolbox est en préversion. Téléchargez-la depuis le [Microsoft Store](https://aka.ms/toolboxinstaller) sur Windows.
</Info>

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](/fr/tools/tools-pc/commandlinetools/gr-wdEndpoint) exécutée sur l'appareil distant. Consultez la [vue d'ensemble de XBOX PC Remote Tools](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/overviews/remote-win-gamedev) 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](/fr/tools/tools-pc/xboxpctoolbox/xboxpctoolbox) 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](#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](#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](#wdremote-action-version) | Affiche la version de wdRemote.exe. |
| [wdRemote /action:status](#wdremote-action-status) | Affiche l'état de la connexion entre le PC de développement et l'appareil cible. |
| [wdRemote /action:deploy](#wdremote-action-deploy) | Déploie un jeu d'un PC de développement vers un appareil Windows distant. |
| [wdRemote /action:launch](#wdremote-action-launch) | Lance un jeu sur un appareil Windows distant. |
| [wdRemote /action:resume](#wdremote-action-resume) | Reprend l'exécution d'un jeu lancé à l'état suspendu sur un appareil Windows distant. |
| [wdRemote /action:terminate](#wdremote-action-terminate) | Arrête le jeu, le travail d'outil ou le processus spécifié sur un appareil Windows distant. |
| [wdRemote /action:copy](#wdremote-action-copy) | Copie des fichiers du PC de développement vers un appareil Windows distant. |
| [wdRemote /action:copyfrom](#wdremote-action-copyfrom) | Copie des fichiers d'un appareil Windows distant vers le PC de développement. |
| [wdRemote /action:delete](#wdremote-action-delete) | Supprime un fichier ou le contenu d'un répertoire sur un appareil Windows distant. |
| [wdRemote /action:run](#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](/fr/tools/tools-pc/commandlinetools/gr-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](/fr/tools/tools-pc/commandlinetools/gr-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.](/fr/tools/tools-pc/commandlinetools/gr-wdRemote)

### wdRemote /action:purgekeys

Tout le trafic entre `wdRemote` et [wdEndpoint](/fr/tools/tools-pc/commandlinetools/gr-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.](/fr/tools/tools-pc/commandlinetools/gr-wdRemote)

## Informations d'état et de version

### wdRemote /action:version

Affiche la version de wdRemote.exe.

`wdRemote /action:version`

[Revenir en haut de cette rubrique.](/fr/tools/tools-pc/commandlinetools/gr-wdRemote)

### 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.](/fr/tools/tools-pc/commandlinetools/gr-wdRemote)

## 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.

```json theme={null}
{
  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`.

```json theme={null}
{
    "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.](/fr/tools/tools-pc/commandlinetools/gr-wdRemote)

### 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.](/fr/tools/tools-pc/commandlinetools/gr-wdRemote)

### 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.](/fr/tools/tools-pc/commandlinetools/gr-wdRemote)

### 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.](/fr/tools/tools-pc/commandlinetools/gr-wdRemote)

## 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. |

<Warning>
  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.
</Warning>

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](/fr/tools/tools-pc/commandlinetools/gr-wdEndpoint)
[XBOX PC Remote Tools](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/overviews/remote-gamedev-tools)


## Related topics

- [Utilisation de XBOX PC Remote Tools](/fr/tools/tools-pc/xbox-pc-remote-tools/how-to-use-tools.md)
- [Outils en ligne de commande pour le développement sur PC](/fr/tools/tools-pc/commandlinetools/gr-commandlinetools-toc.md)
- [Commandlinetools](/fr/tools/tools-pc/commandlinetools/index.md)
- [Versions de XBOX PC Remote Iteration](/fr/reference/remoting/release-versions.md)
- [Point de terminaison d'écoute XBOX PC Remote (wdEndpoint.exe)](/fr/tools/tools-pc/commandlinetools/gr-wdEndpoint.md)