xbox context enregistre des valeurs par défaut pour le vendeur, le titre PlayFab, le titre XBOX et le sandbox, afin
que vous n’ayez pas à les passer à chaque commande. Cette page décrit également où une commande obtient
ces valeurs lorsque vous ne les passez 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 renseigne :
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 passez --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 aucune source ne
fournit une valeur dont une commande a besoin, celle-ci indique comment la définir. Les commandes pour lesquelles le vendeur est
facultatif, xbl et test-account, utilisent votre seul vendeur autorisé.
Une commande qui modifie quelque chose écrit sur stderr chaque valeur qu’elle a renseignée, 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 sont composés de lettres, de chiffres et de traits d’union, jusqu’à 64 caractères, et ne respectent pas la casse.
-
Un profil qui n’existe pas, par exemple un profil mal orthographié, échoue au lieu de revenir à
default. -
Un profil n’emprunte pas de valeurs à
default. -
Les variables
XBOX_restent prioritaires sur un profil. Lorsqu’une variable l’emporte sur le profil nommé par--profile, la commande le signale, 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 d’enregistrement des valeurs
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 renvoie le account connecté, le profile et un tableau values de paires key et value,
avec null pour une clé non 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 principal de service, les commandes qui se connectent
refusent --profile et XBOX_PROFILE, et toutes les commandes context sauf key list échouent. Passez
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 exécutés par votre utilisateur du système d’exploitation, et les variables d’environnement n’apparaissent pas sur la ligne de commande. C’est pourquoi, en plus de nommer chaque valeur qu’elle a renseignée :-
Une opération dont la cible est la valeur de contexte elle-même doit la recevoir sur la ligne de commande.
/Admin/DeleteTitlesupprime le titre, etplayfab api-policy set --overwriteremplace l’ensemble de 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<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 :
