Passer au contenu principal
Cette page répertorie les problèmes connus de la dernière version de l’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 retiré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. Effectuez une recherche dans les problèmes existants.
  3. S’il n’a pas été signalé, signalez-le avec xbox feedback, qui ouvre un rapport de bogue où les détails de votre environnement sont déjà remplis. Les problèmes sont publics; omettez donc tout ce que vous ne partageriez pas publiquement.

Mise à jour de la CLI

xbox upgrade échoue avec l’erreur 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 publics ne fonctionnent pas. Les commandes de configuration des XBOX services et de comptes de test échouent avec l’erreur HTTP 502, signalée comme une indisponibilité du service, mais réessayer ne règle pas le problème. Solution de contournement : joignez votre vendeur dans Partner Center avec un compte professionnel ou scolaire, et connectez-vous à la CLI avec ce compte.

xbox game, xbox xbl et les commandes semblables 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 publics 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 voulu 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 omet parfois l’un d’eux 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 on ne sait pas si le sélectionner dans Partner Center aide.

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 n’est pas le vôtre, par exemple un ID mal saisi, ne les fait pas échouer; elles renvoient vos propres jeux. Solution de contournement : sélectionnez le vendeur voulu dans Partner Center, puis vérifiez que xbox game list affiche ses jeux avant d’en créer un. Le changement peut prendre jusqu’à 15 minutes pour être pris en compte par la CLI.

Les commandes xbox sandbox affichent uniquement les sandboxes 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 trouvent uniquement les sandboxes 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, la commande se termine avec le code 4, car elle ne peut pas relire le sandbox. Ne le créez pas de nouveau. Solution de contournement : sélectionnez le vendeur voulu dans Partner Center, puis exécutez de nouveau la commande avec ce vendeur. Le changement peut prendre jusqu’à 15 minutes pour être pris en compte par la CLI.

Tests avec les tests de jeu et les publics

xbox audience list peut expirer

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

Configuration des XBOX services

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

Certains documents XML publiés qu’enregistre xbox xbl config download --view published, 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 remplacer la stratégie sans confirmation

Avec "OverwritePolicy": true dans le corps de la requête, cet appel remplace l’ensemble de la stratégie d’accès aux API du titre sans les mesures de protection 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 une 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 acceptent des listes séparées par des virgules

--keys pour xbox playfab title-data et xbox playfab player-data, et --member-ids pour xbox playfab group member, acceptent des listes séparées par des virgules. Ces options deviendront des options répétées; 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 accepte le nom en entier, mais delete n’a que --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, avec plutôt /Admin/SetTitleInternalData pour les données de titre internes :
Pour les données de joueur, indiquez la clé dans KeysToRemove, en utilisant l’API de mise à jour correspondant à la visibilité des données dans Données de joueur :

Scripts et agents

La plupart des commandes se terminent avec le code 1 lorsqu’on ignore si une modification a été effectuée

Quelques commandes se terminent avec le code 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 l’indiquent. Toutes les autres commandes, y compris toutes les commandes PlayFab, se terminent avec le code 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 de nouveau.
Dernière modification le 19 novembre 2026