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 comme RETAIL sont gérés par Microsoft; les sandbox de développement comme 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, provenant de --seller-id ou de votre vendeur enregistré; consultez Contexte. S’il ne s’agit pas du dernier vendeur que vous avez sélectionné dans Partner Center, consultez ce problème connu.

Commandes

Arguments et options

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

ID de sandbox

Un ID de sandbox est composé 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 ID globaux comme 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 SANDBOX ID, TYPE et SELLER ID. create refuse --output table.

Créer 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 pourrait être créé dans 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 ce qu’il faut vérifier 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 le sandbox de nouveau.

Erreurs

Un échec écrit du texte sur stderr, quelle que soit la valeur de --output : l’ID de corrélation, des conseils sur le statut HTTP et le détail de l’erreur du service, s’il y en a un. --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