Saltar al contenido principal
La XBOX CLI no necesita ningún archivo de configuración. Su configuración procede de valores predeterminados integrados en el ejecutable, que puedes invalidar para un shell con variables de entorno o para un solo comando con opciones.

Orígenes de configuración y prioridad

La configuración procede de tres orígenes, y los posteriores invalidan a los anteriores:
  1. Valores predeterminados integrados, compilados en el ejecutable. Consulta Opciones de configuración.
  2. Variables de entorno. Consulta Variables de entorno.
  3. Opciones de la línea de comandos. Consulta Invalidaciones con opciones de la CLI.
Cada nueva versión trae sus propios valores predeterminados, así que no hay ningún archivo de configuración que trasladar. El vendedor, el título de PlayFab, el título de XBOX y el sandbox no son opciones de configuración; consulta Contexto para saber de dónde los obtiene un comando.

Opciones de configuración

  • AzureAd:* configuran el inicio de sesión de usuario; consulta Autenticación.
  • PlayFab:StudioBaseUrl es el punto de conexión de PlayFab para las API de estudio (/Studio/*), como las que llama playfab service-principal.
  • XboxPartner:TimeoutSeconds es el tiempo de espera de las solicitudes, en segundos, para comandos como game, y debe ser un número positivo.
  • XblPCSandbox:Path es el XblPCSandbox.exe que ejecutan los comandos pc sandbox. Cuando no está establecido, la CLI busca en su propio directorio y, después, en PATH.
  • AuditLog:Enabled activa el registro de auditoría.
  • Telemetry:* se describen en Telemetría.
Cuando 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 es XBOX_ 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:
Todas las opciones de Opciones de configuración tienen una variable. La CLI también lee estas: 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:
Para desactivarla en un shell:
Consulta Telemetría para saber qué se recopila.

Actualizar desde una versión que leía appsettings.json

Las versiones anteriores leían appsettings.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-env produce este error. Quita la opción y establece variables XBOX_ en su lugar.
  • Mientras haya un archivo appsettings*.json junto 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__VALUE si un mensaje de error anterior te llevó a establecerla. Quita la variable.
Última modificación el 19 de noviembre de 2026