Fontes de configuração e precedência
As configurações vêm de três fontes, e as fontes posteriores substituem as anteriores:- Padrões internos, compilados no executável. Consulte Configurações.
- Variáveis de ambiente. Consulte Variáveis de ambiente.
- Opções de linha de comando. Consulte Substituições por opções da CLI.
Configurações
AzureAd:*configuram o login do usuário; consulte Autenticação.PlayFab:StudioBaseUrlé o ponto de extremidade do PlayFab para APIs de estúdio (/Studio/*), como as queplayfab service-principalchama.XboxPartner:TimeoutSecondsé o tempo limite de solicitação, em segundos, para comandos comogamee precisa ser um número positivo.XblPCSandbox:Pathé oXblPCSandbox.exeque os comandospc sandboxexecutam. Quando ele não está definido, a CLI procura no próprio diretório e, em seguida, emPATH.AuditLog:Enabledativa o log de auditoria.Telemetry:*são descritas em Telemetria.
PlayFab:BaseUrlTemplate, PlayFab:StudioBaseUrl ou XboxPartner:BaseUrl não é o
padrão interno, todos os comandos que enviam um token a esse ponto de extremidade primeiro gravam um aviso em
stderr.
Variáveis de ambiente
A variável de uma configuração éXBOX_ seguido da chave, com __ (dois sublinhados) no lugar de cada :;
assim, Telemetry:Enabled é XBOX_TELEMETRY__ENABLED. Escreva os nomes em maiúsculas. Uma variável se aplica
ao shell que a define e a todos os comandos que esse shell inicia:
As configurações
XBOX_AUTHENTICATION__ são lidas somente de variáveis de ambiente, nunca de padrões
internos nem de opções. Consulte
Autenticação de automação (entidade de serviço).
Substituições por opções da CLI
As opções substituem todas as outras fontes, para um único comando.
Consulte Comandos para ver as outras opções globais.
Configuração da telemetria
As versões oficiais coletam telemetria anônima limitada, a menos que você a desative. Para desativá-la para um único comando:Atualizar a partir de uma versão que lia appsettings.json
As versões anteriores liamappsettings.json ao lado do executável. Se você alterou um valor
nele, defina a variável XBOX_ correspondente: por exemplo, "AzureAd": { "ClientId": "..." } passa a ser
XBOX_AZUREAD__CLIENTID. Você pode ver estas mensagens até concluir:
-
--config-envfalha com este erro. Remova a opção e defina variáveisXBOX_em vez disso. -
Enquanto houver um arquivo
appsettings*.jsonao lado do executável, os comandos gravarão esta observação em stderr. Exclua o arquivo. -
Os comandos do PlayFab falham com um erro que nomeia
XBOX_PLAYFAB__REQUESTHEADERS__0__VALUEse uma mensagem de erro anterior levou você a defini-la. Remova a variável.
