Passer au contenu principal
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 :
  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, par exemple 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 :
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 shell, 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 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 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 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/DeleteTitle supprime le titre, et playfab api-policy set --overwrite remplace 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 --body ou --statements en 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.
Consultez Sécurité et opérations destructrices 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 d’où provient le 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