Exécution (xbrun.exe) - XBOX Game Development Documentation

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

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.

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`. 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. - Si vous n’utilisez pas cette option, la console par défaut (définie précédemment à l’aide de Connexion (xbconnect.exe)) est utilisée. - Utilisez la chaîne accesskey pour limiter l’accès à la console aux seules personnes qui disposent de la clé d’accès. - 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. - 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. - Si une clé d’accès est fournie lors de la définition de la console par défaut avec xbconnect, la clé d’accès est stockée dans l’adresse de la console par défaut. - Pour plus d’informations sur les clés d’accès, consultez xbconfig accesskey.
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

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.

Exemple

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

Voir aussi

Outils en ligne de commande Erreurs de transport XTF Connexion (xbconnect.exe) Gestion des applications (xbapp.exe)

​Remarques

​Exemple

​Voir aussi

Remarques

Exemple

Voir aussi