Pular para o conteúdo principal
Uma sandbox do XBOX é um ambiente isolado em uma conta do Partner Center, para produtos da Microsoft Store e XBOX services. As sandboxes globais, como RETAIL, são gerenciadas pela Microsoft; as sandboxes de desenvolvimento, como ABCDEF.1, pertencem à sua conta. Consulte Sandboxes no Guia de Publicação de Jogos. Para trocar a sandbox que um PC com Windows usa, consulte PC. Cada comando atua em um vendedor, de --seller-id ou do vendedor salvo; consulte Contexto. Se esse não for o vendedor que você selecionou por último no Partner Center, consulte este problema conhecido.

Comandos

Argumentos e opções

Passe uma sandboxId de list para outros comandos, como a opção --sandbox-id dos comandos xbl.

IDs de sandbox

Uma ID de sandbox é composta de letras e dígitos com um sufixo opcional separado por ponto, com até 64 caracteres. A CLI a converte em maiúsculas.
  • get aceita qualquer ID de sandbox, inclusive as globais, como RETAIL e CERT.DEBUG.
  • create precisa de 4 a 60 letras ou dígitos, um ponto e um número de 0 a 999 sem zero à esquerda, como ABCDEF.1. O sufixo .58 é reservado para sandboxes Isolated, e UNDEFINED e os nomes das sandboxes globais não podem ser usados.

Saída

sandbox get grava uma sandbox:
sandbox list grava uma matriz sandboxes com os mesmos objetos:
list --output table tem as colunas SANDBOX, TYPE e GLOBAL, e get --output table tem SANDBOX ID, TYPE e SELLER ID. create recusa --output table.

Criar uma sandbox

sandbox create pergunta antes de criar a sandbox; sem um terminal, ele precisa de --confirm. A CLI não pode excluir uma sandbox. Se você pertencer a vários vendedores, verifique o problema conhecido primeiro: a sandbox pode ser criada em outro vendedor. O comando envia a solicitação uma única vez e aguarda até dois minutos pelo trabalho de criação. Quando o trabalho é bem-sucedido, ele grava a nova sandbox no mesmo formato de sandbox get. A ID do trabalho, a ID de correlação e o que verificar em seguida vão para stderr. Quando o código de saída for 3 ou 4, verifique com sandbox get <sandbox-id> e não crie a sandbox novamente.

Erros

Uma falha grava texto em stderr, qualquer que seja o valor de --output: a ID de correlação, orientações para o status HTTP e o detalhe do erro do serviço, quando houver. --verbose adiciona o corpo da resposta. Os scripts devem se basear no código de saída, e não no texto da mensagem.

Exemplos

Listar sandboxes e obter duas delas:
Criar uma sandbox sem a solicitação de confirmação:
Última modificação em 19 de novembro de 2026