Pular para o conteúdo principal
xbox context salva valores padrão para o vendedor, o título do PlayFab, o título do XBOX e a sandbox, para que você não precise passá-los em todos os comandos. Esta página também descreve de onde um comando obtém esses valores quando você não os passa. O contexto é local: esses comandos não alteram nada no Partner Center nem no PlayFab.

Comandos

Chaves

Uma chave é o nome da opção que ela preenche: Nenhuma outra opção aceita um valor salvo ou uma variável. title-id é uma ID de título do XBOX em hexadecimal, como 1234ABCD, e não uma ID de título do PlayFab. Os comandos xbl a usam para encontrar o identificador de configuração de serviço (SCID) do título e a ignoram quando você passa --scid. Consulte Direcionamento de título.

Como os comandos usam os valores salvos

Quando um comando aceita uma dessas opções, ele usa o primeiro valor que encontra:
  1. A opção na linha de comando, como --seller-id.
  2. A variável XBOX_ da opção, como XBOX_SELLER_ID. Uma variável em branco conta como não definida.
  3. O valor salvo com context set no perfil selecionado.
Um valor vindo de uma variável ou do contexto salvo é verificado como um valor digitado, e um erro indica de onde ele veio, como XBOX_SELLER_ID: --seller-id must be a positive numeric value. Se nada fornecer um valor de que um comando precisa, ele informa como defini-lo. Os comandos em que o vendedor é opcional, xbl e test-account, usam seu único vendedor autorizado. Um comando que altera algo grava em stderr cada valor que preencheu e de onde ele veio, mesmo com --confirm. Com --verbose, todos os comandos fazem isso:
Problemas conhecidos descreve dois problemas que fazem os comandos game e sandbox usarem um vendedor diferente daquele escolhido dessa forma.

Perfis

Um perfil é um conjunto nomeado de valores salvos, como um para um título de teste e outro para produção. Os comandos usam o perfil indicado por --profile; caso contrário, o indicado por XBOX_PROFILE; caso contrário, default.
Para usar um perfil em todos os comandos de um shell, defina XBOX_PROFILE:
Para listar seus perfis:
Para excluir um perfil e todos os valores salvos nele:
  • Salvar o primeiro valor em um perfil o cria. Os nomes contêm letras, dígitos e hifens, com até 64 caracteres, e não diferenciam maiúsculas de minúsculas.
  • Um perfil que não existe, como um com erro de digitação, falha em vez de recorrer a default.
  • Um perfil não herda valores de default.
  • As variáveis XBOX_ continuam prevalecendo sobre um perfil. Quando uma delas prevalece sobre o perfil indicado por --profile, o comando informa isso, mesmo que não altere nada:
  • A CLI não memoriza um perfil entre comandos; portanto, escolher um nunca altera o que outro terminal ou agente usa.

Onde os valores são salvos

Os valores salvos ficam em context.json no diretório de estado da CLI: Cada valor pertence à conta que o salvou, de modo que outra conta não o utiliza. auth logout mantém os valores salvos, e entrar novamente com a mesma conta os restaura.

Argumentos e opções

Comportamento

get retorna a account conectada, o profile e uma matriz values de key e value, com null para uma chave que não está salva. Ele mostra o que está salvo, e não o que um comando usaria; execute o comando com --verbose para ver isso. Sem entrada, get não mostra valores e informa como entrar. set, unset e os comandos profile exigem uma conta conectada. set não verifica o valor com o serviço; portanto, um vendedor que você não pode usar falha no primeiro comando que o envia. Uma entidade de serviço não tem contexto salvo. Em um modo de entidade de serviço, os comandos que entram recusam --profile e XBOX_PROFILE, e todos os comandos context, exceto key list, falham. Em vez disso, passe cada valor com sua opção ou variável XBOX_. Consulte Autenticação de automação (entidade de serviço).

Valores que não vêm da linha de comando

O contexto salvo é compartilhado por todos os terminais e agentes que seu usuário do SO executa, e as variáveis de ambiente não aparecem na linha de comando. Portanto, além de indicar cada valor que preencheu:
  • Uma operação cujo destino é o próprio valor do contexto deve tê-lo na linha de comando. /Admin/DeleteTitle exclui o título, e playfab api-policy set --overwrite substitui toda a sua política de acesso à API; por isso, cada um recusa um título vindo do contexto salvo ou de uma variável e imprime o comando a ser executado em vez disso:
    O comando impresso omite um valor embutido de --body ou --statements, porque o corpo de uma solicitação pode conter segredos. Coloque o valor de volta no lugar de <body> ou <statements>.
  • Se outra conta entrar enquanto um comando que usa valores salvos estiver em execução, por exemplo enquanto ele aguarda confirmação, o comando para antes de enviar qualquer coisa. Execute-o novamente.
Consulte Segurança e operações destrutivas para conhecer as regras de confirmação.

Saída em tabela

Todos os comandos de contexto aceitam --output table:

Exemplos

Liste as chaves que você pode salvar:
Salve um vendedor e um título do PlayFab e verifique o que está salvo:
Execute comandos que usam os valores salvos e veja de onde veio o título:
Remova um valor salvo:
Remova todos os valores salvos no perfil selecionado:
Consulte Configuração para conhecer as configurações, que o contexto não altera.
Última modificação em 19 de novembro de 2026