Saltar al contenido principal
Un sandbox de XBOX es un entorno aislado de una cuenta de Partner Center, para productos de Microsoft Store y servicios de XBOX. Microsoft administra los sandboxes globales, como RETAIL; los sandboxes de desarrollo, como ABCDEF.1, pertenecen a tu cuenta. Consulta Sandboxes en la guía de publicación de juegos. Para cambiar el sandbox que usa un PC con Windows, consulta PC. Cada comando actúa sobre un vendedor, a partir de --seller-id o de tu vendedor guardado; consulta Contexto. Si no es el vendedor que seleccionaste por última vez en Partner Center, consulta este problema conocido.

Comandos

Argumentos y opciones

Pasa un sandboxId de list a otros comandos, como la opción --sandbox-id de los comandos xbl.

Identificadores de sandbox

Un identificador de sandbox está formado por letras y dígitos con un sufijo opcional separado por un punto, de hasta 64 caracteres. La CLI lo convierte a mayúsculas.
  • get acepta cualquier identificador de sandbox, incluidos los globales, como RETAIL y CERT.DEBUG.
  • create necesita de 4 a 60 letras o dígitos, un punto y un número del 0 al 999 sin cero inicial, como ABCDEF.1. El sufijo .58 está reservado para los sandboxes aislados, y no se pueden usar UNDEFINED ni los nombres de los sandboxes globales.

Salida

sandbox get escribe un sandbox:
sandbox list escribe una matriz sandboxes de los mismos objetos:
list --output table tiene las columnas SANDBOX, TYPE y GLOBAL, y get --output table tiene SANDBOX ID, TYPE y SELLER ID. create rechaza --output table.

Creación de un sandbox

sandbox create pregunta antes de crear el sandbox; sin un terminal, necesita --confirm. La CLI no puede eliminar un sandbox. Si perteneces a varios vendedores, consulta primero el problema conocido: el sandbox se puede crear en otro vendedor. El comando envía la solicitud una sola vez y espera hasta dos minutos al trabajo de creación. Cuando el trabajo se completa correctamente, escribe el nuevo sandbox con la misma forma que sandbox get. El identificador del trabajo, el identificador de correlación y lo que debes comprobar a continuación van a stderr. Cuando el código de salida es 3 o 4, compruébalo con sandbox get <sandbox-id> y no vuelvas a crear el sandbox.

Errores

Un error escribe texto en stderr, sea cual sea --output: el identificador de correlación, indicaciones para el estado HTTP y el detalle del error del servicio, cuando lo hay. --verbose agrega el cuerpo de la respuesta. Los scripts deben bifurcarse según el código de salida, no según el texto.

Ejemplos

Enumerar sandboxes y obtener dos de ellos:
Crear un sandbox sin la solicitud de confirmación:
Última modificación el 19 de noviembre de 2026