Passer au contenu principal
Un sandbox XBOX est un environnement isolé d’un compte Partner Center, destiné aux produits du Microsoft Store et aux XBOX services. Les sandbox globaux tels que RETAIL sont gérés par Microsoft ; les sandbox de développement tels que ABCDEF.1 appartiennent à votre compte. Consultez Sandbox dans le guide de publication de jeux. Pour changer le sandbox qu’utilise un PC Windows, consultez PC. Chaque commande agit sur un seul vendeur, issu de --seller-id ou de votre vendeur enregistré ; consultez Contexte. S’il ne s’agit pas du vendeur que vous avez sélectionné en dernier dans Partner Center, consultez ce problème connu.

Commandes

Arguments et options

Passez un sandboxId provenant de list à d’autres commandes, comme l’option --sandbox-id des commandes xbl.

ID de sandbox

Un ID de sandbox se compose de lettres et de chiffres avec un suffixe facultatif séparé par un point, jusqu’à 64 caractères. La CLI le convertit en majuscules.
  • get accepte n’importe quel ID de sandbox, y compris les sandbox globaux tels que RETAIL et CERT.DEBUG.
  • create a besoin de 4 à 60 lettres ou chiffres, d’un point et d’un nombre de 0 à 999 sans zéro initial, comme ABCDEF.1. Le suffixe .58 est réservé aux sandbox Isolated, et UNDEFINED ainsi que les noms des sandbox globaux ne peuvent pas être utilisés.

Sortie

sandbox get écrit un sandbox :
sandbox list écrit un tableau sandboxes contenant les mêmes objets :
list --output table comporte les colonnes SANDBOX, TYPE et GLOBAL, et get --output table comporte les colonnes SANDBOX ID, TYPE et SELLER ID. create refuse --output table.

Création d’un sandbox

sandbox create demande une confirmation avant de créer le sandbox ; sans terminal, elle a besoin de --confirm. La CLI ne peut pas supprimer un sandbox. Si vous appartenez à plusieurs vendeurs, consultez d’abord le problème connu : le sandbox peut être créé chez un autre vendeur. La commande envoie la requête une seule fois et attend jusqu’à deux minutes le travail de création. Lorsque le travail réussit, elle écrit le nouveau sandbox sous la même forme que sandbox get. L’ID du travail, l’ID de corrélation et les vérifications à effectuer ensuite sont écrits sur stderr. Lorsque le code de sortie est 3 ou 4, vérifiez avec sandbox get <sandbox-id>, et ne créez pas de nouveau le sandbox.

Erreurs

Un échec écrit du texte sur stderr, quel que soit --output : l’ID de corrélation, des conseils sur le statut HTTP et le détail de l’erreur du service, le cas échéant. --verbose ajoute le corps de la réponse. Les scripts doivent se baser sur le code de sortie, et non sur le libellé.

Exemples

Répertorier les sandbox, et en obtenir deux :
Créer un sandbox sans l’invite de confirmation :
Dernière modification le 19 novembre 2026