> ## 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 l'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 les commandes expérimentales, dont le contrat CLI peut changer ou être retiré.
Consultez [Commandes expérimentales](https://docs.xbox.com/fr-CA/tools/xbox-cli/cli-command-lifecycle.md).

## Commandes principales

| Commande | Description |
| - | - |
| [`auth`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/auth) | S'authentifier auprès de Microsoft Entra ID. |
| [`context`](https://docs.xbox.com/fr-CA/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-CA/tools/xbox-cli/commands/game) | Répertorier, obtenir et créer des jeux Partner Center. |
| [`seller`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/seller) | Répertorier les vendeurs Partner Center accessibles au développeur connecté. |
| [`sandbox`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/sandbox) | Répertorier, obtenir et créer des sandboxes XBOX. |
| [`audience`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/audience) | Répertorier, obtenir, créer et mettre à jour les publics d'un vendeur (expérimentale). |
| [`package`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/package) | Répertorier et obtenir des packages de jeu (expérimentale). |
| [`playtest`](https://docs.xbox.com/fr-CA/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-CA/tools/xbox-cli/commands/pc) | Obtenir ou changer le sandbox XBOX qu'utilise ce PC Windows (expérimentale). |
| [`test-account`](https://docs.xbox.com/fr-CA/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 trouver le lot d'un compte et savoir si son accès a expiré. |
| [`playfab`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/playfab) | Inspecter et gérer les services PlayFab. |
| [`xbl`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/xbl) | Gérer la configuration des XBOX services (expérimentale). |

## Commandes de soutien

| Commande | Description |
| - | - |
| [`info`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/info) | Afficher la version et les liens de prise en main. |
| [`upgrade`](https://docs.xbox.com/fr-CA/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-CA/tools/xbox-cli/commands/feedback) | Ouvrir un brouillon de rapport de bogue contenant des informations sur l'environnement de la CLI. |
| [`help`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/help) | Afficher l'aide de n'importe quelle commande. |

## Options globales

Toutes les commandes acceptent ces options. Certaines n'ont d'effet que sur 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 sur le titre enregistré, sans modifier ni l'un ni l'autre. Consultez [Contexte](https://docs.xbox.com/fr-CA/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-CA/tools/xbox-cli/commands/context.md#profiles). |
| `--client-id <id>` | Connexion d'un utilisateur | Remplacer `AzureAd:ClientId`. Refusée lors d'une connexion en tant que principal de service. |
| `--tenant-id <id>` | Connexion d'un 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-CA/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 une confirmation. Consultez [Sécurité](https://docs.xbox.com/fr-CA/tools/xbox-cli/safety.md). |
| `--verbose` | Toutes les commandes | Écrire des détails de diagnostic sur stderr, y compris la provenance de chaque [valeur enregistrée](https://docs.xbox.com/fr-CA/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 sur l'utilisation du produit pour cette exécution. Consultez [Télémétrie](https://docs.xbox.com/fr-CA/tools/xbox-cli/telemetry.md). |

Les options remplacent les paramètres et les variables d'environnement; consultez [Configuration](https://docs.xbox.com/fr-CA/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, pour une redirection vers `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` retire; consultez
[Enveloppe de réponse](https://docs.xbox.com/fr-CA/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 l'indiquent. `auth status`
écrit du texte, sauf si vous passez `--output json` ou `--output json-compact`; consultez
[Auth](https://docs.xbox.com/fr-CA/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-CA/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 affichage sous forme de 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 apparaît uniquement 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 qui échoue écrit le JSON d'erreur sur stderr dans le format `--output`; consultez
[Réponses d'erreur PlayFab](https://docs.xbox.com/fr-CA/tools/xbox-cli/playfab-api.md#error-responses). Une commande inconnue écrit une erreur
et sa syntaxe sur stderr; consultez [Aide](https://docs.xbox.com/fr-CA/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 de nouveau; consultez
[Une écriture interrompue signale que son résultat est inconnu](https://docs.xbox.com/fr-CA/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 destructrices](https://docs.xbox.com/fr-CA/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-CA/tools/xbox-cli/cli-command-lifecycle.md)
- [Commande serve](https://docs.xbox.com/fr-CA/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command.md)
- [Commande unpack](https://docs.xbox.com/fr-CA/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-unpack-command.md)
- [Commande verify](https://docs.xbox.com/fr-CA/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-CA/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-settings-command.md)
