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

# Commandes

> La référence des commandes de la CLI, avec ses options globales, ses formats de sortie et une page pour chaque commande.

Cette page est la référence des commandes de la XBOX CLI. Elle couvre `xbox` lui-même : les
options globales, les formats de sortie et les codes de sortie communs à toutes les commandes. Chaque commande ci-dessous a sa
propre page, et chaque service `playfab` a une page sous `commands/playfab/`. Exécutez
`xbox <command> --help` pour voir la même référence dans votre terminal.

L'aide étiquette comme Experimental les commandes dont le contrat de CLI peut changer ou être supprimé.
Consultez [Commandes expérimentales](https://docs.xbox.com/fr/tools/xbox-cli/cli-command-lifecycle.md).

## Commandes principales

| Commande | Description |
| - | - |
| [`auth`](https://docs.xbox.com/fr/tools/xbox-cli/commands/auth) | S'authentifier avec Microsoft Entra ID. |
| [`context`](https://docs.xbox.com/fr/tools/xbox-cli/commands/context) | Enregistrer des valeurs par défaut, comme le vendeur et le titre PlayFab, pour les commandes suivantes. |
| [`game`](https://docs.xbox.com/fr/tools/xbox-cli/commands/game) | Répertorier, obtenir et créer des jeux Partner Center. |
| [`seller`](https://docs.xbox.com/fr/tools/xbox-cli/commands/seller) | Répertorier les vendeurs Partner Center disponibles pour le développeur connecté. |
| [`sandbox`](https://docs.xbox.com/fr/tools/xbox-cli/commands/sandbox) | Répertorier, obtenir et créer des sandbox XBOX. |
| [`audience`](https://docs.xbox.com/fr/tools/xbox-cli/commands/audience) | Répertorier, obtenir, créer et mettre à jour les audiences d'un vendeur (Expérimental). |
| [`package`](https://docs.xbox.com/fr/tools/xbox-cli/commands/package) | Répertorier et obtenir des packages de jeu (Expérimental). |
| [`playtest`](https://docs.xbox.com/fr/tools/xbox-cli/commands/playtest) | Répertorier, obtenir, comparer, créer, mettre à jour, publier et supprimer les tests de jeu d'un jeu. |
| [`pc`](https://docs.xbox.com/fr/tools/xbox-cli/commands/pc) | Obtenir ou changer le sandbox XBOX utilisé par ce PC Windows (Expérimental). |
| [`test-account`](https://docs.xbox.com/fr/tools/xbox-cli/commands/test-account) | Créer, mettre à jour et supprimer des lots de comptes de test XBOX, suivre leurs tâches de création, lire les lots, et rechercher le lot d'un compte et si son accès a expiré. |
| [`playfab`](https://docs.xbox.com/fr/tools/xbox-cli/commands/playfab) | Inspecter et gérer les services PlayFab. |
| [`xbl`](https://docs.xbox.com/fr/tools/xbox-cli/commands/xbl) | Gérer la configuration des XBOX services (Expérimental). |

## Commandes d'assistance

| Commande | Description |
| - | - |
| [`info`](https://docs.xbox.com/fr/tools/xbox-cli/commands/info) | Afficher la version et les liens de prise en main. |
| [`upgrade`](https://docs.xbox.com/fr/tools/xbox-cli/commands/upgrade) | Rechercher une version plus récente de la CLI et afficher les instructions de mise à jour manuelle. |
| [`feedback`](https://docs.xbox.com/fr/tools/xbox-cli/commands/feedback) | Ouvrir un brouillon de rapport de bogue avec les informations sur l'environnement de la CLI. |
| [`help`](https://docs.xbox.com/fr/tools/xbox-cli/commands/help) | Afficher l'aide de n'importe quelle commande. |

## Options globales

Toutes les commandes acceptent ces options. Certaines n'affectent que certaines commandes, comme l'indique le tableau ;
ailleurs, elles sont acceptées et ignorées.

| Option | S'applique à | Description |
| - | - | - |
| `--playfab-title-id <id>` | Commandes `playfab` | Le titre PlayFab à cibler. L'emporte sur `XBOX_PLAYFAB_TITLE_ID` et le titre enregistré, sans modifier ni l'un ni l'autre. Consultez [Contexte](https://docs.xbox.com/fr/tools/xbox-cli/commands/context.md). |
| `--profile <name>` | Commandes qui utilisent des valeurs enregistrées | Utiliser les valeurs enregistrées dans ce profil. Par défaut, `XBOX_PROFILE`, puis `default`. Consultez [Profils](https://docs.xbox.com/fr/tools/xbox-cli/commands/context.md#profiles). |
| `--client-id <id>` | Connexion utilisateur | Remplacer `AzureAd:ClientId`. Refusée lors d'une connexion en tant que principal de service. |
| `--tenant-id <id>` | Connexion utilisateur | Remplacer `AzureAd:TenantId`. Refusée lors d'une connexion en tant que principal de service. |
| `--scopes <scopes>` | Connexion | Remplacer `AzureAd:Scopes`. |
| `--output <format>`, `-o` | Commandes de données | `json` (par défaut), `json-compact`, ou `table` pour les commandes qui le prennent en charge. Consultez [Formats de sortie](#output-formats). |
| `--data-only` | Commandes `playfab` | Écrire uniquement le champ `data` de la réponse PlayFab. Consultez [Enveloppe de réponse](https://docs.xbox.com/fr/tools/xbox-cli/commands/playfab.md#response-envelope). |
| `--confirm`, `--yes`, `-y` | Commandes `playfab` et commandes dont la page la mentionne | Ignorer l'invite de confirmation d'une commande qui demande d'abord. Consultez [Sécurité](https://docs.xbox.com/fr/tools/xbox-cli/safety.md). |
| `--verbose` | Toutes les commandes | Écrire des informations de diagnostic détaillées sur stderr, y compris la provenance de chaque [valeur enregistrée](https://docs.xbox.com/fr/tools/xbox-cli/commands/context.md#how-commands-use-saved-values) utilisée par une commande. |
| `--disable-telemetry` | Toutes les commandes | Désactiver la télémétrie anonyme d'utilisation du produit pour cette exécution. Consultez [Télémétrie](https://docs.xbox.com/fr/tools/xbox-cli/telemetry.md). |

Les options remplacent les paramètres et les variables d'environnement ; consultez [Configuration](https://docs.xbox.com/fr/tools/xbox-cli/configuration.md).

## Formats de sortie

Les commandes de données écrivent leur résultat sur stdout, et les erreurs et diagnostics sur stderr.

| Format | Sortie |
| - | - |
| `json` | JSON mis en forme. Format par défaut. |
| `json-compact` | JSON sur une seule ligne, à transmettre à `jq` ou à un script. |
| `table` | Un tableau en texte brut, pour les commandes dont la page indique qu'elles l'acceptent. |

Les commandes PlayFab encapsulent chaque résultat dans une enveloppe de réponse que `--data-only` supprime ; consultez
[Enveloppe de réponse](https://docs.xbox.com/fr/tools/xbox-cli/commands/playfab.md#response-envelope). `--data-only` n'a aucun effet sur
les autres commandes ni avec `--output table`.

Quelques commandes écrivent du texte destiné aux personnes au lieu de JSON, et leurs pages le précisent. `auth status`
écrit du texte, sauf si vous passez `--output json` ou `--output json-compact` ; consultez
[Auth](https://docs.xbox.com/fr/tools/xbox-cli/commands/auth.md#auth-status). Les opérations sur les fichiers, comme `playfab file upload`, n'écrivent
rien sur stdout et signalent ce qu'elles ont fait sur stderr ; consultez [Fichiers](https://docs.xbox.com/fr/tools/xbox-cli/commands/playfab/file.md#output).

### Sortie sous forme de tableau

Les tableaux sont destinés à être lus dans un terminal. Leurs colonnes peuvent changer dans n'importe quelle version : les scripts
et les agents doivent donc utiliser `--output json-compact`. Une commande sans vue tableau refuse
`table` :

```console theme={null}
$ xbox playfab api /Admin/GetTitleData --output table
Output format 'table' is not available for this command, because it does not declare a
table view. Omit --output to get this command's default output.
```

### Progression

Les commandes qui lisent de nombreuses pages, comme `game list`, ou qui attendent une requête, comme
`xbl config publish`, affichent leur progression sur une ligne de stderr :
`Reading games... 1646 found, 25 pages, 84s`. La ligne n'apparaît que lorsque stderr est un terminal,
et elle est effacée avant le résultat.

## Codes de sortie

Ces codes de sortie sont communs à toutes les commandes. Les commandes qui modifient quelque chose peuvent ajouter leurs
propres codes, comme `3` lorsque le résultat d'une modification est inconnu, et leurs pages les répertorient.

| Code de sortie | Signification |
| - | - |
| `0` | La commande a réussi. |
| `1` | La commande a échoué. L'erreur figure sur stderr. |
| `130` | Vous avez appuyé sur Ctrl+C pendant que la commande lisait ou attendait. |

Un appel PlayFab en échec écrit le JSON d'erreur sur stderr au format `--output` ; consultez
[Réponses d'erreur PlayFab](https://docs.xbox.com/fr/tools/xbox-cli/playfab-api.md#error-responses). Une commande inconnue écrit une erreur
et l'utilisation sur stderr ; consultez [Aide](https://docs.xbox.com/fr/tools/xbox-cli/commands/help.md).

Si vous appuyez sur Ctrl+C après qu'une commande a envoyé une modification, elle indique sur stderr si la modification a pu
être effectuée. Elle se termine avec le code documenté sur sa page, ou `1` pour une commande PlayFab. Vérifiez
avant de l'exécuter à nouveau ; consultez
[Une écriture interrompue signale que son résultat est inconnu](https://docs.xbox.com/fr/tools/xbox-cli/safety.md#an-interrupted-write-reports-that-its-outcome-is-unknown).

## Sécurité

De nombreuses commandes modifient des titres, des vendeurs et des jeux de production, et seules les opérations PlayFab dont
le nom commence par `Get`, `List` ou `Search` sont en lecture seule. Lisez
[Sécurité et opérations destructives](https://docs.xbox.com/fr/tools/xbox-cli/safety.md) avant d'exécuter des commandes qui modifient quelque chose.


## Related topics

- [Commandes expérimentales](https://docs.xbox.com/fr/tools/xbox-cli/cli-command-lifecycle.md)
- [Commande serve](https://docs.xbox.com/fr/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command.md)
- [Commande verify](https://docs.xbox.com/fr/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-verify-command.md)
- [Commande settings](https://docs.xbox.com/fr/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-settings-command.md)
- [Commande notice](https://docs.xbox.com/fr/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-notice-command.md)
