Pular para o conteúdo principal
Os comandos pc obtêm ou trocam a sandbox do XBOX que este PC com Windows usa. Eles são Experimentais e são executados somente no Windows. Consulte Comandos experimentais. Um PC usa uma sandbox por vez, para todos os usuários e todos os jogos nele, e os jogos entram nessa sandbox. O padrão é RETAIL. Para testar um jogo em uma sandbox de desenvolvimento, como ABCDEF.1, troque o PC para ela primeiro. Para ver quais sandboxes sua conta do Partner Center tem, use xbox sandbox list.

Comandos

Cada comando executa o XblPCSandbox.exe, o XBOX services PC Sandbox Switcher, e funciona da forma que a documentação dele descreve. Para o comando /feedback da ferramenta, execute XblPCSandbox /feedback diretamente.

Trocar de sandbox

pc sandbox set altera a sandbox para todos os usuários do PC. Ele pergunta antes de trocar e, em seguida, mostra uma solicitação do Controle de Conta de Usuário (UAC) para obter direitos de administrador. Ele reinicia os XBOX services no PC e reabre a Microsoft Store e o aplicativo XBOX se eles estavam abertos. Depois, verifica se o PC usa a nova sandbox. set faz a troca mesmo quando o PC já usa a sandbox. Executá-lo novamente reinicia os serviços, o que corrige uma entrada que ainda usa a sandbox antiga. Se isso não ajudar, reinicie o PC e consulte Solução de problemas de sandboxes. Troque para RETAIL antes de atualizar o aplicativo XBOX ou o Gaming Services pela Microsoft Store.

Instalar a ferramenta

O XblPCSandbox.exe é fornecido com o XBOX Game Development Kit (GDK) e no XboxLiveTools.zip na página de versões das ferramentas de desenvolvimento dos XBOX services. O Gaming Services, o serviço do Windows que executa os recursos do XBOX no PC, precisa estar instalado. A CLI procura a ferramenta nesta ordem:
  1. A configuração XblPCSandbox:Path, como a variável de ambiente XBOX_XBLPCSANDBOX__PATH.
  2. A pasta que contém a CLI.
  3. Cada pasta em PATH.

Opções

Saída

get e launch-apps retornam {"sandbox": "ABCDEF.1"}, e set retorna {"sandbox": "ABCDEF.1", "previousSandbox": "RETAIL"}. Com --output table, as colunas são SANDBOX e, para set, PREVIOUS SANDBOX. A saída da própria ferramenta vai para stderr.

Erros

Os erros da ferramenta têm links para Solução de problemas de sandboxes e sugerem XblPCSandbox /feedback para relatar um problema.

Exemplos

Obter a sandbox que este PC usa:
Trocar para uma sandbox de desenvolvimento sem reabrir a Microsoft Store e o aplicativo XBOX e, em seguida, reabri-los:
Voltar para RETAIL:
Última modificação em 19 de novembro de 2026