> ## 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 expérimentales

> Dans quelle mesure les commandes peuvent changer avant et après la version 1.0, et ce que signifie l'étiquette Expérimental.

L'ampleur des changements qu'une commande peut subir d'une version à l'autre dépend de la version de la CLI et du fait que
l'aide étiquette ou non la commande `[Experimental]`. Une étiquette sur un groupe de commandes s'applique à chaque commande
qu'il contient.

## Avant la version 1.0

Jusqu'à la version 1.0, l'XBOX CLI est en préversion, et n'importe quelle commande peut changer ou être
retirée d'une version à l'autre, qu'elle soit étiquetée Expérimental ou non. Cela comprend ses chemins,
ses arguments, ses options, ses valeurs par défaut, sa sortie structurée et ses codes de sortie. Pour l'automatisation, épinglez une
version testée de la CLI et testez vos flux de travail avant de procéder à une mise à niveau.

## À partir de la version 1.0

À partir de la version 1.0, les commandes qui ne sont pas étiquetées Expérimental respectent leur contrat
documenté. Un changement qui brise l'automatisation n'arrive que dans une version qui indique qu'il s'agit d'un changement cassant.
Le contrat couvre :

* Les chemins des commandes et des sous-commandes.
* Les noms et la signification des arguments et des options.
* Les entrées obligatoires.
* Les valeurs par défaut documentées.
* La sortie JSON documentée, y compris les noms et la signification des champs.
* Les codes de sortie documentés.

De nouvelles commandes, options et propriétés JSON peuvent apparaître dans n'importe quelle version; vos scripts doivent donc
ignorer les propriétés JSON qu'ils ne reconnaissent pas. La sortie destinée aux personnes, comme le texte et
les tableaux, ne fait pas partie du contrat.

### Transmission directe d'API

Lorsqu'une commande renvoie la réponse d'un service telle quelle, comme le fait `xbox playfab api`, cette
réponse suit le contrat de compatibilité propre au service, et non celui de la CLI. Les entrées de la CLI,
ses codes de sortie et la sortie qu'elle ajoute, comme l'enveloppe de réponse que `--data-only`
retire, restent couverts.

## Expérimental

Les commandes expérimentales sont publiées pour recueillir des commentaires sur leur interface. Même après la version 1.0, leurs
chemins, options, valeurs par défaut, sortie et comportement peuvent changer, ou les commandes peuvent être retirées;
ne comptez donc pas sur le maintien de la compatibilité de l'automatisation qui les utilise.

Les commandes expérimentales sont terminées et testées, et suivent les mêmes règles de sécurité
que toutes les autres commandes, y compris la confirmation avant les opérations destructrices. Elles s'exécutent comme
n'importe quelle autre commande; vous n'avez pas besoin de les activer.


## Related topics

- [Commandes](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands.md)
- [XBOX CLI](https://docs.xbox.com/fr-CA/tools/xbox-cli/index.md)
- [Playtest](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/playtest.md)
- [Aide](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/help.md)
- [Package](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/package.md)
