> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Problèmes connus

> Problèmes et fonctionnalités inachevées de la dernière version de la XBOX CLI, et comment les contourner.

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`](https://docs.xbox.com/fr/tools/xbox-cli/commands/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`](https://docs.xbox.com/fr/tools/xbox-cli/commands/upgrade).
2. Recherchez parmi les [problèmes existants](https://github.com/xbox/cli/issues).
3. S'il n'a pas été signalé, signalez-le avec [`xbox feedback`](https://docs.xbox.com/fr/tools/xbox-cli/commands/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`](https://docs.xbox.com/fr/tools/xbox-cli/commands/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](https://docs.xbox.com/fr/tools/xbox-cli/installation.md).

## 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`](https://docs.xbox.com/fr/tools/xbox-cli/commands/playfab/service-principal). Consultez
[Authentification pour l'automatisation (principal de service)](https://docs.xbox.com/fr/tools/xbox-cli/authentication.md#automation-service-principal-authentication).

### 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`](https://docs.xbox.com/fr/tools/xbox-cli/commands/seller)
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`](https://docs.xbox.com/fr/tools/xbox-cli/commands/audience), 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`](https://docs.xbox.com/fr/tools/xbox-cli/commands/game) 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](https://docs.xbox.com/fr/tools/xbox-cli/commands/context.md) : `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](https://docs.xbox.com/fr/tools/xbox-cli/commands/context.md) n'est pas
celui que vous avez sélectionné en dernier dans Partner Center,
[`xbox sandbox list` et `xbox sandbox get`](https://docs.xbox.com/fr/tools/xbox-cli/commands/sandbox) 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`](https://docs.xbox.com/fr/tools/xbox-cli/commands/audience) 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`](https://docs.xbox.com/fr/tools/xbox-cli/commands/xbl) 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`](https://docs.xbox.com/fr/tools/xbox-cli/commands/playfab/api-policy),
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`](https://docs.xbox.com/fr/tools/xbox-cli/commands/playfab/group), 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`](https://docs.xbox.com/fr/tools/xbox-cli/commands/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 :

```bash theme={null}
xbox --playfab-title-id ABC123 playfab api /Admin/SetTitleData --body '{"Key":"Level,Bonus","Value":null}'
```

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](https://docs.xbox.com/fr/tools/xbox-cli/commands/playfab/player-data.md) :

```bash theme={null}
xbox --playfab-title-id ABC123 playfab api /Admin/UpdateUserData --body '{"PlayFabId":"PLAYER123","KeysToRemove":["Level,Bonus"]}'
```

## 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.


## Related topics

- [Prise en main de Unity pour le développement PC (contenu)](https://docs.xbox.com/fr/build/gdk-and-engines/unity/unity.md)
- [FAQ et guide de résolution des problèmes des XBOX PC Remote Tools](https://docs.xbox.com/fr/tools/tools-pc/xbox-pc-remote-tools/faq.md)
- [Utiliser Playtest](https://docs.xbox.com/fr/publishing/game-publishing/concepts/playtest-preview.md)
- [Notes de version - XBOX PC Remote Tools (mars 2026)](https://docs.xbox.com/fr/tools/tools-pc/xbox-pc-remote-tools/release-notes/2603.md)
- [Notes de prise en charge du GDK pour Visual Studio 2019](https://docs.xbox.com/fr/tools/tools-console/visualstudio/vs-2019-support-notes.md)
