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

# Exécution (xbrun.exe)

> Exécution (xbrun.exe)

Utilisez cet outil pour démarrer un exécutable (c'est-à-dire un outil de test) sur une console distante.

<Note>Si un exécutable transmis à **xbrun** appelle `XGameRuntimeInitialize`, il rencontre le message d'échec "The image was not launched as a game". Pour lancer un exécutable qui appelle `XGameRuntimeInitialize` à l'aide d'un outil en ligne de commande, utilisez [xbapp launch](/fr/tools/tools-console/commandlinetools/xbapp#xbapp_launch).</Note>

| Colonne 1 |
| - |
| **xbrun** \[/D\[:]*path*] \[/G] \[/I] \[/O] \[/W] \[/J] \[/L] \[/V] \[/X\[:]*address\[+`<accesskey>`]*] *command* |

| Option | Description |
| - | - |
| /D\[:]*path* | Spécifie le répertoire de travail de la commande. Si aucun répertoire n'est spécifié, `%SystemRoot%` est utilisé par défaut. |
| /G | Lance le processus en tant qu'utilisateur invité. Par défaut, les processus sont lancés en tant qu'utilisateur système. |
| /I | Redirige l'entrée vers la console locale. Tout texte saisi dans la fenêtre de console actuelle est redirigé vers la console distante. |
| /O | Redirige la sortie vers la console locale. Tout texte affiché dans la fenêtre de la console distante est redirigé vers la console locale. |
| /W | Avant de se fermer, attend la fin du processus distant. Si **/I**, **/O** ou les deux sont spécifiés, **/W** est implicite. |
| /V | Affiche une sortie détaillée. Cette option ajoute des informations sur la provenance des valeurs de retour (code de sortie provenant du processus exécuté à distance ou de xbrun). |
| /L | Met en forme la sortie pour un fichier journal. N'a d'effet que si /O est spécifiée. |
| /J | Lance le nouveau processus dans l'objet de traitement (job object) des outils. Ne s'applique qu'à la partition `title`. <br />**REMARQUE :** utilisez cette option avec précaution, car l'objet de traitement des outils dispose d'une mémoire réservée très limitée, partagée par tous les processus qu'il contient. Le dépassement de la limite globale met fin à l'objet de traitement des outils, à tous les processus qu'il contient et à la connexion des outils à la partition `title` (jusqu'à son redémarrage). |
| /X\[:]*address\[+`<accesskey>`]* | - Utilisez cette option pour spécifier le nom d'hôte ou l'adresse (affichée en tant que **Tools IP** sur la console) d'une console cible sans modifier la console par défaut. Pour plus d'informations sur la définition d'un nom d'hôte pour une console, consultez [Définir un nom d'hôte pour l'adresse IP de la console](/fr/home/setup-install/dev-kit-settings/setting-a-hostname).<br />- Si vous n'utilisez pas cette option, la console par défaut (définie précédemment à l'aide de [Connexion (xbconnect.exe)](/fr/tools/tools-console/commandlinetools/xbconnect)) est utilisée. <br />- Utilisez la chaîne *accesskey* pour limiter l'accès à la console aux seules personnes qui disposent de la clé d'accès. <br />- Définissez la clé d'accès à l'aide de la commande **xbconfig** **accesskey=your-key**, puis redémarrez votre console pour que la clé d'accès prenne effet.<br />- Pour accéder à une console configurée avec une clé d'accès, ajoutez un signe plus (+) suivi de la clé d'accès après l'adresse IP ou le nom d'hôte de la console.<br />- Si une clé d'accès est fournie lors de la définition de la console par défaut avec [xbconnect](/fr/tools/tools-console/commandlinetools/xbconnect), la clé d'accès est stockée dans l'adresse de la console par défaut.<br />- Pour plus d'informations sur les clés d'accès, consultez [xbconfig accesskey](/fr/tools/tools-console/commandlinetools/xbconfig). |
| *command* | Commande à exécuter et arguments à transmettre à l'exécutable. La commande est le dernier paramètre transmis à **xbrun**. Tous les paramètres supplémentaires sont automatiquement ajoutés à la commande et transmis à l'appareil distant. Le type de fichier des exécutables doit être spécifié. Par exemple, la commande **net** doit être spécifiée sous la forme net.exe. |
| /LC | Spécifiez le code de paramètres régionaux. Permet de remplacer le code de paramètres régionaux par défaut |

<a id="remarks" />

## Remarques

* **xbrun** s'exécute en tant qu'utilisateur invité avec des privilèges système dans la partition `exclusive`.

* **xbrun** prend en charge les variables d'environnement, qui sont développées sur l'appareil distant. Par exemple, `%SystemRoot%` est automatiquement développée vers le répertoire du système d'exploitation de l'appareil distant.

* Les guillemets entourant les paramètres sont supprimés automatiquement. Pour conserver un guillemet dans la ligne de commande transmise à l'appareil distant, faites-le précéder d'une barre oblique inverse (\\).

* Si la commande que vous spécifiez ne contient pas de chemin de répertoire, le système recherche le fichier exécutable dans l'ordre suivant.
  1. Le répertoire système de Windows
  2. Le répertoire Windows
  3. Les répertoires répertoriés dans la variable d'environnement PATH

* Lors d'une tentative de chargement de l'exécutable, **xbrun** ne recherche *pas* automatiquement dans le répertoire de travail spécifié à l'aide du commutateur **/D**.

* De nombreuses applications console (dont cmd.exe) lisent leur entrée directement depuis la console, et non depuis le canal d'entrée standard. Ces applications ne prennent pas en charge le commutateur **/I**. De même, la sortie de toute application qui écrit directement dans la console au lieu de **stdout** ou **stderr** n'est pas redirigée par le commutateur **/O**.

<a id="ID4EIF" />

## Exemple

```
xbrun /O /D:%SystemRoot%\System32 CMD.EXE /C ECHO Here are some \"quotes.\"  
```

<a id="ID4EOF" />

## Voir aussi

[Outils en ligne de commande](/fr/tools/tools-console/commandlinetools/commandlinetools)

[Erreurs de transport XTF](/fr/tools/tools-console/commandlinetools/xtf-transport-errors)

[Connexion (xbconnect.exe)](/fr/tools/tools-console/commandlinetools/xbconnect)

[Gestion des applications (xbapp.exe)](/fr/tools/tools-console/commandlinetools/xbapp)


## Related topics

- [Outils en ligne de commande pour le développement sur console](/fr/tools/tools-console/commandlinetools/commandlinetools.md)
- [Outils en ligne de commande](/fr/tools/tools-console/commandlinetools/index.md)
- [Exécution (wdRun.exe)](/fr/tools/tools-console/console_commandlinetools/wdrun.md)
- [ActionExecutionError](/fr/services/playfab/api-references/events/data-types/actionexecutionerror.md)
- [ScriptExecutionError](/fr/services/playfab/api-references/events/data-types/scriptexecutionerror.md)