Passer au contenu principal
Cette page répertorie les problèmes connus de la dernière version de la XBOX CLI, y compris les fonctionnalités inachevées. Si votre problème figure ici, vous n’avez pas besoin de le signaler. Seule la dernière version est prise en charge. xbox upgrade vous indique si une version plus récente est disponible. Une entrée marquée Corrigé est corrigée dans la dernière version, et elle est supprimée dans la suivante.

Si votre problème ne figure pas dans la liste

  1. Vérifiez que vous exécutez la dernière version avec xbox upgrade.
  2. Recherchez parmi les problèmes existants.
  3. S’il n’a pas été signalé, signalez-le avec xbox feedback, qui ouvre un rapport de bogue prérempli avec les détails de votre environnement. Les problèmes signalés sont publics : n’y incluez rien que vous ne partageriez pas publiquement.

Mise à jour de la CLI

xbox upgrade échoue avec HTTP 301

Corrigé Le dépôt public de la CLI a été déplacé, et xbox upgrade dans la version v0.2.1 échoue systématiquement avec HTTP 301: GitHub release metadata is unavailable. Solution de contournement : téléchargez la dernière version en suivant Installation.

Connexion et autorisations

Certaines commandes ne fonctionnent pas encore avec un compte Microsoft personnel

Lorsque vous vous connectez avec un compte Microsoft personnel plutôt qu’avec un compte professionnel ou scolaire, les commandes relatives à la configuration des XBOX services, aux comptes de test, aux packages, aux tests de jeu et aux audiences ne fonctionnent pas. Les commandes de configuration des XBOX services et de comptes de test échouent avec HTTP 502, signalé comme une indisponibilité du service, mais réessayer n’y change rien. Solution de contournement : rejoignez votre vendeur dans Partner Center avec un compte professionnel ou scolaire, puis connectez-vous à la CLI avec ce compte.

xbox game, xbox xbl et les commandes similaires n’acceptent pas encore les principaux de service

Un principal de service peut se connecter, mais les commandes audience, game, package, playtest, sandbox, seller, test-account et xbl échouent avec une erreur d’autorisation lorsqu’il les exécute, car le service qu’elles appellent n’accepte pas encore les principaux de service. Solution de contournement : exécutez ces commandes en tant qu’utilisateur connecté. Les commandes xbox playfab fonctionnent avec un principal de service une fois qu’une personne lui a accordé l’accès avec xbox playfab service-principal set. Consultez Authentification pour l’automatisation (principal de service).

Des commandes sont refusées pour certains vendeurs lorsque vous appartenez à plusieurs vendeurs

Si vous appartenez à plusieurs vendeurs Partner Center, les commandes relatives à la configuration des XBOX services, aux comptes de test, aux packages, aux tests de jeu et aux audiences peuvent être refusées pour tous les vendeurs, sauf celui que vous avez sélectionné en dernier dans Partner Center. Solution de contournement : sélectionnez le vendeur souhaité dans Partner Center, puis exécutez de nouveau la commande.

xbox seller list omet parfois l’un de vos vendeurs

Si vous appartenez à plusieurs vendeurs Partner Center, xbox seller list en omet parfois un sans erreur, et l’exécution suivante peut le répertorier. Tant qu’il est absent, les commandes pour ce vendeur, comme xbox audience list, peuvent être refusées, et le sélectionner dans Partner Center n’est pas réputé résoudre le problème.

Les commandes xbox game ignorent --seller-id

xbox game list, xbox game get et xbox game create utilisent le vendeur que vous avez sélectionné en dernier dans Partner Center, et non celui que vous passez avec --seller-id ou que vous enregistrez dans le contexte : game create peut donc créer le jeu chez un autre vendeur. Un ID de vendeur qui ne vous appartient pas, par exemple un ID mal saisi, ne les fait pas échouer : elles renvoient vos propres jeux. Solution de contournement : sélectionnez le vendeur souhaité dans Partner Center, puis vérifiez que xbox game list affiche ses jeux avant d’en créer un. La modification peut mettre jusqu’à 15 minutes pour atteindre la CLI.

Les commandes xbox sandbox n’affichent que les sandbox globaux

Lorsque le vendeur que vous passez avec --seller-id ou que vous enregistrez dans le contexte n’est pas celui que vous avez sélectionné en dernier dans Partner Center, xbox sandbox list et xbox sandbox get ne trouvent que les sandbox CERT, CERT.DEBUG et RETAIL, sans échouer. xbox sandbox create crée le sandbox chez le vendeur que vous avez sélectionné en dernier et, s’il s’agit d’un autre vendeur, se termine avec 4 car elle ne peut pas relire le sandbox. Ne le créez pas une seconde fois. Solution de contournement : sélectionnez le vendeur souhaité dans Partner Center, puis exécutez de nouveau la commande avec ce vendeur. La modification peut mettre jusqu’à 15 minutes pour atteindre la CLI.

Tests avec des tests de jeu et des audiences

xbox audience list peut expirer

xbox audience list peut prendre suffisamment de temps pour que la requête expire. --name n’aide pas, car il filtre la liste après la lecture de toutes les audiences.

Configuration des XBOX services

Certains documents XML téléchargés déclarent un mauvais encodage

Certains documents XML publiés que xbox xbl config download --view published enregistre, comme mpsdtitleinfo.xml et titlename-localization.xml, déclarent encoding="utf-16" mais sont encodés en UTF-8 : un lecteur XML qui se fie à la déclaration ne parvient donc pas à les charger. Solution de contournement : décodez le fichier en UTF-8 avant de l’analyser.

PlayFab

xbox playfab api /Admin/UpdatePolicy peut écraser la stratégie sans confirmation

Avec "OverwritePolicy": true dans le corps de la requête, cet appel remplace l’intégralité de la stratégie d’accès aux API du titre sans les protections de xbox playfab api-policy set --overwrite : il ne nécessite pas --confirm, et il peut utiliser le titre du contexte enregistré ou de XBOX_PLAYFAB_TITLE_ID. Une stratégie erronée peut bloquer l’accès au titre pour tous les joueurs. Solution de contournement : utilisez plutôt xbox playfab api-policy set --overwrite, qui nécessite --confirm et le titre passé avec --playfab-title-id.

playfab title-data delete et playfab player-data delete ne demandent pas de confirmation

Les autres commandes qui suppriment quelque chose demandent confirmation avant de s’exécuter, ou refusent de s’exécuter sans --confirm. Ces deux commandes suppriment immédiatement les clés que vous nommez.

--keys et --member-ids prennent des listes séparées par des virgules

--keys sur xbox playfab title-data et xbox playfab player-data, et --member-ids sur xbox playfab group member, prennent des listes séparées par des virgules. Ces options deviendront des options répétables : les scripts qui les utilisent devront donc être mis à jour. D’ici là, --keys ne peut pas nommer une clé qui contient une virgule. Pour lire une telle clé, passez-la avec --key, qui prend le nom en entier, mais delete ne dispose que de --keys. Solution de contournement : pour supprimer la clé, appelez l’API qu’utilise delete avec xbox playfab api. Pour les données de titre, définissez la valeur de la clé sur null, en utilisant plutôt /Admin/SetTitleInternalData pour les données de titre internes :
Pour les données des joueurs, indiquez la clé dans KeysToRemove, en utilisant l’API de mise à jour correspondant à la visibilité des données, décrite dans Données des joueurs :

Scripts et agents

La plupart des commandes se terminent avec 1 lorsqu’on ne sait pas si une modification a été appliquée

Quelques commandes se terminent avec 3 lorsqu’elles ne peuvent pas déterminer si une modification a été effectuée, par exemple lorsque la requête expire après son envoi, et leurs pages le précisent. Toutes les autres commandes, y compris toutes les commandes PlayFab, se terminent avec 1 pour tout échec : un script ne peut donc pas distinguer ce cas d’une modification qui n’a pas été effectuée. Solution de contournement : lorsqu’une commande qui modifie quelque chose échoue, vérifiez l’état actuel avant de l’exécuter à nouveau.
Dernière modification le 19 novembre 2026