xbox context enregistre des valeurs par défaut pour le vendeur, le titre PlayFab, le titre XBOX et le sandbox, pour que
vous n’ayez pas à les transmettre à chaque commande. Cette page décrit aussi où une commande obtient
ces valeurs lorsque vous ne les transmettez pas. Le contexte est local : ces commandes ne modifient rien dans
Partner Center ni dans PlayFab.
Commandes
Clés
Une clé porte le nom de l’option qu’elle remplit :
Aucune autre option n’accepte de valeur enregistrée ni de variable.
title-id est un ID de titre XBOX en hexadécimal, comme 1234ABCD, et non un ID de titre PlayFab. Les
commandes xbl l’utilisent pour trouver l’identificateur de configuration de service (SCID) du titre, et l’ignorent
lorsque vous transmettez --scid. Consultez Ciblage du titre.
Utilisation des valeurs enregistrées par les commandes
Lorsqu’une commande accepte l’une de ces options, elle utilise la première valeur qu’elle trouve :- L’option sur la ligne de commande, comme
--seller-id. - La variable
XBOX_de l’option, commeXBOX_SELLER_ID. Une variable vide est considérée comme non définie. - La valeur enregistrée avec
context setdans le profil sélectionné.
XBOX_SELLER_ID: --seller-id must be a positive numeric value. Si rien ne
fournit une valeur dont une commande a besoin, celle-ci indique comment en définir une. Les commandes pour lesquelles le vendeur est
facultatif, xbl et test-account, utilisent votre seul vendeur autorisé.
Une commande qui modifie quelque chose écrit dans stderr chaque valeur qu’elle a remplie, ainsi que sa provenance,
même avec --confirm. Avec --verbose, toutes les commandes le font :
game et sandbox
à utiliser un vendeur différent de celui choisi de cette façon.
Profils
Un profil est un ensemble nommé de valeurs enregistrées, par exemple un pour un titre de test et un pour la production. Les commandes utilisent le profil nommé par--profile, sinon celui nommé par XBOX_PROFILE, sinon default.
XBOX_PROFILE :
- L’enregistrement de la première valeur dans un profil crée celui-ci. Les noms se composent de lettres, de chiffres et de traits d’union, jusqu’à 64 caractères, et ne sont pas sensibles à la casse.
-
Un profil qui n’existe pas, par exemple un profil mal orthographié, échoue au lieu de se rabattre sur
default. -
Un profil n’emprunte pas de valeurs à
default. -
Les variables
XBOX_ont toujours priorité sur un profil. Lorsqu’une variable a priorité sur le profil nommé par--profile, la commande l’indique, même si elle ne modifie rien : - La CLI ne mémorise pas de profil d’une commande à l’autre; en choisir un ne modifie donc jamais ce qu’utilise un autre terminal ou agent.
Emplacement des valeurs enregistrées
Les valeurs enregistrées se trouvent danscontext.json, dans le répertoire d’état de la CLI :
Chaque valeur appartient au compte qui l’a enregistrée; un autre compte ne la récupère donc pas.
auth logout conserve les valeurs enregistrées, et une nouvelle connexion avec le même compte les restaure.
Arguments et options
Comportement
get retourne le account connecté, le profile et un tableau values de key et value,
avec null pour une clé qui n’est pas enregistrée. Il affiche ce qui est enregistré, et non ce qu’une commande utiliserait; exécutez
la commande avec --verbose pour le voir. Sans connexion, get n’affiche aucune valeur et indique comment se
connecter.
set, unset et les commandes profile nécessitent un compte connecté. set ne vérifie pas la
valeur auprès du service; un vendeur que vous ne pouvez pas utiliser échoue donc à la première commande qui l’envoie.
Un principal de service n’a pas de contexte enregistré. Dans un mode de principal de service, les commandes qui se connectent
refusent --profile et XBOX_PROFILE, et toutes les commandes context sauf key list échouent. Transmettez
plutôt chaque valeur avec son option ou sa variable XBOX_. Consultez
Authentification pour l’automatisation (principal de service).
Valeurs qui ne proviennent pas de la ligne de commande
Le contexte enregistré est partagé par tous les terminaux et agents qu’exécute votre utilisateur du système d’exploitation, et les variables d’environnement n’apparaissent pas sur la ligne de commande. Ainsi, en plus de nommer chaque valeur qu’elle a remplie :-
Une opération dont la cible est la valeur de contexte elle-même doit l’avoir sur la ligne de commande.
/Admin/DeleteTitlesupprime le titre, etplayfab api-policy set --overwriteremplace toute sa stratégie d’accès à l’API; chacune refuse donc un titre provenant du contexte enregistré ou d’une variable, et affiche la commande à exécuter à la place :La commande affichée omet une valeur--bodyou--statementsen ligne, car un corps de requête peut contenir des secrets. Remettez la valeur à la place de<body>ou de<statements>. - Si un autre compte se connecte pendant l’exécution d’une commande qui utilise des valeurs enregistrées, par exemple pendant qu’elle attend une confirmation, la commande s’arrête avant d’envoyer quoi que ce soit. Exécutez-la de nouveau.
Sortie sous forme de tableau
Toutes les commandes de contexte acceptent--output table :
