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

# Comandos experimentais

> O quanto os comandos podem mudar antes e depois da versão 1.0 e o que significa o rótulo Experimental.

O quanto um comando pode mudar entre versões depende da versão da CLI e de a
Ajuda rotular ou não o comando como `[Experimental]`. Um rótulo em um grupo de comandos se aplica a todos os comandos
do grupo.

## Antes da 1.0

Até a versão 1.0, a XBOX CLI está em versão prévia, e qualquer comando pode mudar ou ser
removido entre versões, esteja ele rotulado como Experimental ou não. Isso inclui seus caminhos,
argumentos, opções, padrões, saída estruturada e códigos de saída. Para automação, fixe uma versão testada
da CLI e teste seus fluxos de trabalho antes de atualizar.

## A partir da 1.0

A partir da versão 1.0, os comandos que não estão rotulados como Experimental mantêm seu contrato
documentado. Uma alteração que interrompa a automação só vem em uma versão que declare ser uma alteração interruptiva.
O contrato abrange:

* Caminhos de comandos e subcomandos.
* Nomes e significados de argumentos e opções.
* Quais entradas são obrigatórias.
* Padrões documentados.
* Saída JSON documentada, incluindo nomes e significados de campos.
* Códigos de saída documentados.

Novos comandos, opções e propriedades JSON podem aparecer em qualquer versão; portanto, seus scripts devem
ignorar as propriedades JSON que não reconhecem. A saída escrita para pessoas, como texto e
tabelas, não faz parte do contrato.

### Passagem direta da API

Quando um comando retorna a resposta de um serviço como ela é, como faz `xbox playfab api`, essa
resposta segue o contrato de compatibilidade do próprio serviço, não o da CLI. As entradas da CLI,
os códigos de saída e a saída que ela adiciona, como o envelope de resposta que `--data-only`
remove, continuam abrangidos.

## Experimental

Os comandos experimentais são lançados para coletar comentários sobre a interface. Mesmo após a 1.0, seus
caminhos, opções, padrões, saída e comportamento podem mudar, ou os comandos podem ser removidos;
portanto, não conte com a permanência da compatibilidade de automações que os utilizam.

Os comandos experimentais estão concluídos e testados e seguem as mesmas regras de segurança e proteção
que todos os outros comandos, incluindo a confirmação antes de operações destrutivas. Eles são executados como
qualquer outro comando; você não precisa ativá-los.


## Related topics

- [Comandos](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands.md)
- [Ajuda](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/help.md)
- [Pacote](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/package.md)
- [Playtest](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/playtest.md)
- [PC](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/pc.md)
