Passer au contenu principal
Les commandes pc obtiennent ou changent le sandbox XBOX qu’utilise ce PC Windows. Elles sont expérimentales et ne s’exécutent que sous Windows. Consultez Commandes expérimentales. Un PC utilise un seul sandbox à la fois, pour tous les utilisateurs et tous les jeux qu’il contient, et les jeux se connectent à ce sandbox. La valeur par défaut est RETAIL. Pour tester un jeu dans un sandbox de développement tel que ABCDEF.1, basculez d’abord le PC vers celui-ci. Pour voir de quels sandbox dispose votre compte Partner Center, utilisez xbox sandbox list.

Commandes

Chaque commande exécute XblPCSandbox.exe, le PC Sandbox Switcher des XBOX services, et fonctionne comme le décrit sa documentation. Pour la commande /feedback de l’outil, exécutez directement XblPCSandbox /feedback.

Changement de sandbox

pc sandbox set change le sandbox pour tous les utilisateurs du PC. Elle demande une confirmation avant de basculer, puis affiche une invite du Contrôle de compte d’utilisateur (UAC) pour obtenir les droits d’administrateur. Elle redémarre les XBOX services sur le PC, et rouvre le Microsoft Store et l’application XBOX s’ils étaient ouverts. Elle vérifie ensuite que le PC utilise le nouveau sandbox. set effectue le basculement même lorsque le PC utilise déjà le sandbox. L’exécuter de nouveau redémarre les services, ce qui corrige une connexion qui utilise encore l’ancien sandbox. Si cela ne suffit pas, redémarrez le PC et consultez Résolution des problèmes liés aux sandbox. Basculez vers RETAIL avant de mettre à jour l’application XBOX ou Gaming Services depuis le Microsoft Store.

Installation de l’outil

XblPCSandbox.exe est fourni avec le kit de développement de jeux XBOX (GDK), ainsi que dans XboxLiveTools.zip sur la page des versions des outils de développement des XBOX services. Gaming Services, le service Windows qui exécute les fonctionnalités XBOX sur le PC, doit être installé. La CLI recherche l’outil dans cet ordre :
  1. Le paramètre XblPCSandbox:Path, par exemple via la variable d’environnement XBOX_XBLPCSANDBOX__PATH.
  2. Le dossier qui contient la CLI.
  3. Chaque dossier du PATH.

Options

Sortie

get et launch-apps renvoient {"sandbox": "ABCDEF.1"}, et set renvoie {"sandbox": "ABCDEF.1", "previousSandbox": "RETAIL"}. Avec --output table, les colonnes sont SANDBOX, ainsi que PREVIOUS SANDBOX pour set. La sortie propre de l’outil est écrite sur stderr.

Erreurs

Les erreurs de l’outil renvoient vers Résolution des problèmes liés aux sandbox et suggèrent XblPCSandbox /feedback pour signaler un problème.

Exemples

Obtenir le sandbox qu’utilise ce PC :
Basculer vers un sandbox de développement sans rouvrir le Microsoft Store et l’application XBOX, puis les rouvrir :
Revenir à RETAIL :
Dernière modification le 19 novembre 2026