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:- La opción en la línea de comandos, como
--seller-id. - La variable
XBOX_de la opción, comoXBOX_SELLER_ID. Una variable en blanco se considera no establecida. - El valor guardado con
context seten el perfil seleccionado.
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:
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.
XBOX_PROFILE:
- 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 encontext.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/DeleteTitleelimina el título, yplayfab api-policy set --overwritereemplaza 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--bodyo--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.
Salida de tabla
Todos los comandos de contexto aceptan--output table:
