Saltar al contenido principal
xbox context guarda valores predeterminados para el vendedor, el título de PlayFab, el título de XBOX y el sandbox, para que no tengas que pasarlos a cada comando. Esta página también describe de dónde obtiene un comando estos valores cuando no los pasas. El contexto es local: estos comandos no cambian nada en Partner Center ni en PlayFab.

Comandos

Claves

Una clave es el nombre de la opción que rellena: Ninguna otra opción acepta un valor guardado ni una variable. title-id es un identificador de título de XBOX en hexadecimal, como 1234ABCD, no un identificador de título de PlayFab. Los comandos xbl lo usan para encontrar el identificador de configuración de servicio (SCID) del título, y lo ignoran cuando pasas --scid. Consulta Selección del título.

Cómo usan los comandos los valores guardados

Cuando un comando acepta una de estas opciones, usa el primer valor que encuentra:
  1. La opción en la línea de comandos, como --seller-id.
  2. La variable XBOX_ de la opción, como XBOX_SELLER_ID. Una variable en blanco se considera no establecida.
  3. El valor guardado con context set en el perfil seleccionado.
Un valor procedente de una variable o del contexto guardado se comprueba igual que uno escrito, y un error indica de dónde procede, como XBOX_SELLER_ID: --seller-id must be a positive numeric value. Si nada proporciona un valor que un comando necesita, el comando indica cómo establecerlo. Los comandos en los que el vendedor es opcional, xbl y test-account, usan tu único vendedor autorizado. Un comando que cambia algo escribe en stderr cada valor que rellenó, y su procedencia, incluso con --confirm. Con --verbose, lo hacen todos los comandos:
Problemas conocidos describe dos problemas que hacen que los comandos game y sandbox usen un vendedor distinto del elegido de esta forma.

Perfiles

Un perfil es un conjunto con nombre de valores guardados, como uno para un título de prueba y otro para producción. Los comandos usan el perfil que indica --profile; si no, el que indica XBOX_PROFILE; y si no, default.
Para usar un perfil en todos los comandos de un shell, establece XBOX_PROFILE:
Para enumerar tus perfiles:
Para eliminar un perfil y todos los valores guardados en él:
  • Al guardar el primer valor en un perfil, este se crea. Los nombres constan de letras, dígitos y guiones, hasta 64 caracteres, y no distinguen mayúsculas de minúsculas.
  • Un perfil que no existe, como uno mal escrito, produce un error en lugar de recurrir a default.
  • Un perfil no toma valores prestados de default.
  • Las variables XBOX_ siguen prevaleciendo sobre un perfil. Cuando una prevalece sobre el perfil que indica --profile, el comando lo dice, aunque no cambie nada:
  • La CLI no recuerda un perfil entre comandos, por lo que elegir uno nunca cambia lo que usa otro terminal u otro agente.

Dónde se guardan los valores

Los valores guardados están en context.json, en el directorio de estado de la CLI: Cada valor pertenece a la cuenta que lo guardó, por lo que otra cuenta no lo recoge. auth logout conserva los valores guardados, y volver a iniciar sesión con la misma cuenta los restaura.

Argumentos y opciones

Comportamiento

get devuelve la account con la sesión iniciada, el profile y una matriz values de key y value, con null para una clave que no está guardada. Muestra lo que está guardado, no lo que usaría un comando; ejecuta el comando con --verbose para verlo. Sin una sesión iniciada, get no muestra valores e indica cómo iniciar sesión. set, unset y los comandos profile necesitan una cuenta con la sesión iniciada. set no comprueba el valor con el servicio, por lo que un vendedor que no puedes usar produce un error en el primer comando que lo envía. Una entidad de servicio no tiene contexto guardado. En un modo de entidad de servicio, los comandos que inician sesión rechazan --profile y XBOX_PROFILE, y todos los comandos context excepto key list producen un error. En su lugar, pasa cada valor con su opción o su variable XBOX_. Consulta Autenticación de automatización (entidad de servicio).

Valores que no proceden de la línea de comandos

Todos los terminales y agentes que ejecuta tu usuario del SO comparten el contexto guardado, y las variables de entorno no aparecen en la línea de comandos. Por eso, además de indicar cada valor que rellenó:
  • Una operación cuyo destino es el propio valor del contexto debe tenerlo en la línea de comandos. /Admin/DeleteTitle elimina el título, y playfab api-policy set --overwrite reemplaza toda su directiva de acceso a la API, por lo que ambos rechazan un título procedente del contexto guardado o de una variable, e imprimen el comando que se debe ejecutar en su lugar:
    El comando impreso omite un valor insertado de --body o --statements, porque el cuerpo de una solicitud puede contener secretos. Vuelve a colocar el valor en lugar de <body> o <statements>.
  • Si otra cuenta inicia sesión mientras se ejecuta un comando que usa valores guardados, por ejemplo mientras espera la confirmación, el comando se detiene antes de enviar nada. Vuelve a ejecutarlo.
Consulta Seguridad y operaciones destructivas para conocer las reglas de confirmación.

Salida de tabla

Todos los comandos de contexto aceptan --output table:

Ejemplos

Enumera las claves que puedes guardar:
Guarda un vendedor y un título de PlayFab, y comprueba lo que está guardado:
Ejecuta comandos que usan los valores guardados y comprueba de dónde procede el título:
Quita un valor guardado:
Quita todos los valores guardados en el perfil seleccionado:
Consulta Configuración para conocer las opciones de configuración, que el contexto no cambia.
Última modificación el 19 de noviembre de 2026