Passer au contenu principal
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 :
  1. L’option sur la ligne de commande, comme --seller-id.
  2. La variable XBOX_ de l’option, comme XBOX_SELLER_ID. Une variable vide est considérée comme non définie.
  3. La valeur enregistrée avec context set dans le profil sélectionné.
Une valeur provenant d’une variable ou du contexte enregistré est vérifiée comme une valeur saisie, et une erreur indique sa provenance, comme 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 :
La page Problèmes connus décrit deux problèmes qui amènent les commandes 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.
Pour utiliser un profil pour toutes les commandes d’un interpréteur de commandes, définissez XBOX_PROFILE :
Pour répertorier vos profils :
Pour supprimer un profil et toutes les valeurs qui y sont enregistrées :
  • 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 dans context.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/DeleteTitle supprime le titre, et playfab api-policy set --overwrite remplace 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 --body ou --statements en 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.
Consultez Sécurité et opérations destructives pour connaître les règles de confirmation.

Sortie sous forme de tableau

Toutes les commandes de contexte acceptent --output table :

Exemples

Répertorier les clés que vous pouvez enregistrer :
Enregistrer un vendeur et un titre PlayFab, puis vérifier ce qui est enregistré :
Exécuter des commandes qui utilisent les valeurs enregistrées, et voir la provenance du titre :
Supprimer une valeur enregistrée :
Supprimer toutes les valeurs enregistrées dans le profil sélectionné :
Consultez Configuration pour les paramètres, que le contexte ne modifie pas.
Dernière modification le 19 novembre 2026