> ## 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 l'XBOX CLI, et comment les contourner.

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`](https://docs.xbox.com/fr-CA/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
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`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/upgrade).
2. Effectuez une recherche dans 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-CA/tools/xbox-cli/commands/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`](https://docs.xbox.com/fr-CA/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-CA/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 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`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/playfab/service-principal). Consultez
[Authentification pour l'automatisation (principal de service)](https://docs.xbox.com/fr-CA/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 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`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/seller)
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`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/audience), 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`](https://docs.xbox.com/fr-CA/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-CA/tools/xbox-cli/commands/context.md); `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](https://docs.xbox.com/fr-CA/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-CA/tools/xbox-cli/commands/sandbox) 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`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/audience) 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`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/xbl), 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`](https://docs.xbox.com/fr-CA/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 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`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/playfab/group), 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`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/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 :

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

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](https://docs.xbox.com/fr-CA/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 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.


## Related topics

- [Prise en main de Unity pour le développement PC (contenu)](https://docs.xbox.com/fr-CA/build/gdk-and-engines/unity/unity.md)
- [Utiliser Playtest](https://docs.xbox.com/fr-CA/publishing/game-publishing/concepts/playtest-preview.md)
- [Notes de version - XBOX PC Remote Tools (mars 2026)](https://docs.xbox.com/fr-CA/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-CA/tools/tools-console/visualstudio/vs-2019-support-notes.md)
- [Notes de prise en charge de Visual Studio 2019](https://docs.xbox.com/fr-CA/tools/tools-pc/visualstudio/gr-vs-2019-support-notes.md)
