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:- A opção na linha de comando, como
--seller-id. - A variável
XBOX_da opção, comoXBOX_SELLER_ID. Uma variável em branco conta como não definida. - O valor salvo com
context setno perfil selecionado.
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:
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.
XBOX_PROFILE:
- 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 emcontext.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/DeleteTitleexclui o título, eplayfab api-policy set --overwritesubstitui 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--bodyou--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.
Saída em tabela
Todos os comandos de contexto aceitam--output table:
