Orígenes de configuración y prioridad
La configuración procede de tres orígenes, y los posteriores invalidan a los anteriores:- Valores predeterminados integrados, compilados en el ejecutable. Consulta Opciones de configuración.
- Variables de entorno. Consulta Variables de entorno.
- Opciones de la línea de comandos. Consulta Invalidaciones con opciones de la CLI.
Opciones de configuración
AzureAd:*configuran el inicio de sesión de usuario; consulta Autenticación.PlayFab:StudioBaseUrles el punto de conexión de PlayFab para las API de estudio (/Studio/*), como las que llamaplayfab service-principal.XboxPartner:TimeoutSecondses el tiempo de espera de las solicitudes, en segundos, para comandos comogame, y debe ser un número positivo.XblPCSandbox:Pathes elXblPCSandbox.exeque ejecutan los comandospc sandbox. Cuando no está establecido, la CLI busca en su propio directorio y, después, enPATH.AuditLog:Enabledactiva el registro de auditoría.Telemetry:*se describen en Telemetría.
PlayFab:BaseUrlTemplate, PlayFab:StudioBaseUrl o XboxPartner:BaseUrl no tienen el
valor predeterminado integrado, todos los comandos que envían un token a ese punto de conexión escriben primero una advertencia en
stderr.
Variables de entorno
La variable de una opción de configuración esXBOX_ seguida de su clave, con __ (dos guiones bajos) en lugar de cada :,
de modo que Telemetry:Enabled es XBOX_TELEMETRY__ENABLED. Escribe los nombres en mayúsculas. Una variable se aplica
al shell que la establece y a todos los comandos que ese shell inicia:
La configuración de
XBOX_AUTHENTICATION__ solo se lee de variables de entorno, nunca de valores predeterminados
integrados ni de opciones. Consulta
Autenticación para automatización (entidad de servicio).
Invalidaciones con opciones de la CLI
Las opciones invalidan cualquier otro origen para un comando.
Consulta Comandos para ver las demás opciones globales.
Configuración de la telemetría
Las versiones oficiales recopilan telemetría anónima limitada a menos que la desactives. Para desactivarla en un comando:Actualizar desde una versión que leía appsettings.json
Las versiones anteriores leíanappsettings.json junto al ejecutable. Si cambiaste un valor en
ese archivo, establece en su lugar su variable XBOX_: por ejemplo, "AzureAd": { "ClientId": "..." } pasa a ser
XBOX_AZUREAD__CLIENTID. Es posible que veas estos mensajes hasta que termines:
-
--config-envproduce este error. Quita la opción y establece variablesXBOX_en su lugar. -
Mientras haya un archivo
appsettings*.jsonjunto al ejecutable, los comandos escriben esta nota en stderr. Elimina el archivo. -
Los comandos de PlayFab producen un error que menciona
XBOX_PLAYFAB__REQUESTHEADERS__0__VALUEsi un mensaje de error anterior te llevó a establecerla. Quita la variable.
