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

L'ampleur des changements possibles d'une commande entre deux versions 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 à toutes les commandes
qu'il contient.

## Avant la version 1.0

Jusqu'à la version 1.0, la XBOX CLI est en préversion, et toute commande peut changer ou être
supprimée d'une version à l'autre, qu'elle soit étiquetée Experimental ou non. Cela inclut ses chemins,
arguments, options, valeurs par défaut, sortie structurée et codes de sortie. Pour l'automatisation, épinglez une version testée
de la CLI et testez vos workflows avant de mettre à niveau.

## À partir de la version 1.0

À partir de la version 1.0, les commandes qui ne sont pas étiquetées Experimental respectent leur contrat
documenté. Une modification qui casse l'automatisation n'arrive que dans une version qui indique explicitement qu'elle est cassante.
Le contrat couvre :

* Les chemins des commandes et sous-commandes.
* Les noms et significations 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 significations 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 de l'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`
supprime, 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 supprimées :
ne comptez donc pas sur la compatibilité continue d'une 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 destructives. 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/tools/xbox-cli/commands.md)
- [Playtest](https://docs.xbox.com/fr/tools/xbox-cli/commands/playtest.md)
- [Aide](https://docs.xbox.com/fr/tools/xbox-cli/commands/help.md)
- [Package](https://docs.xbox.com/fr/tools/xbox-cli/commands/package.md)
- [Votre premier test de jeu](https://docs.xbox.com/fr/tools/xbox-cli/first-playtest.md)
