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

# 실험적 명령

> 1.0 릴리스 전후에 명령이 얼마나 변경될 수 있는지와 실험적 레이블의 의미입니다.

릴리스 간에 명령이 얼마나 변경될 수 있는지는 CLI의 버전과 도움말에서 해당 명령에
`[Experimental]` 레이블이 지정되어 있는지에 따라 달라집니다. 명령 그룹의 레이블은 그룹에 속한 모든 명령에
적용됩니다.

## 1.0 이전

1.0 릴리스 전까지 XBOX CLI는 미리 보기 상태이며, 실험적 레이블 지정 여부와 관계없이
모든 명령이 릴리스 간에 변경되거나 제거될 수 있습니다. 여기에는 명령의 경로,
인수, 옵션, 기본값, 구조화된 출력 및 종료 코드가 포함됩니다. 자동화를 위해서는 테스트된
CLI 버전을 고정하고 업그레이드하기 전에 워크플로를 테스트하세요.

## 1.0부터

1.0 릴리스부터 실험적 레이블이 지정되지 않은 명령은 문서화된
계약을 유지합니다. 자동화를 중단시키는 변경은 호환성이 깨지는 변경이라고 명시한 릴리스에서만 제공됩니다.
계약에는 다음이 포함됩니다.

* 명령 및 하위 명령 경로.
* 인수 및 옵션 이름과 의미.
* 필수 입력.
* 문서화된 기본값.
* 필드 이름과 의미를 포함한 문서화된 JSON 출력.
* 문서화된 종료 코드.

새 명령, 옵션 및 JSON 속성은 모든 릴리스에서 추가될 수 있으므로 스크립트는
인식하지 못하는 JSON 속성을 무시해야 합니다. 텍스트 및 표와 같이 사람이 읽도록 작성된 출력은
계약에 포함되지 않습니다.

### API 패스스루

`xbox playfab api`처럼 명령이 서비스의 응답을 그대로 반환하는 경우, 해당
응답은 CLI가 아니라 서비스 자체의 호환성 계약을 따릅니다. CLI의 입력,
종료 코드 및 CLI가 추가하는 출력(예: `--data-only`가 제거하는 응답 봉투)은
여전히 계약에 포함됩니다.

## 실험적

실험적 명령은 인터페이스에 대한 피드백을 받기 위해 릴리스됩니다. 1.0 이후에도
경로, 옵션, 기본값, 출력 및 동작이 변경되거나 명령이 제거될 수 있으므로,
이러한 명령을 사용하는 자동화가 계속 호환될 것이라고 가정하지 마세요.

실험적 명령은 완성되고 테스트되었으며, 파괴적 작업 전 확인을 포함하여 다른 모든 명령과
동일한 보안 및 안전 규칙을 따릅니다. 다른 명령처럼 실행되므로
따로 켤 필요가 없습니다.


## Related topics

- [명령](https://docs.xbox.com/ko/tools/xbox-cli/commands.md)
- [XBOX CLI](https://docs.xbox.com/ko/tools/xbox-cli/index.md)
- [Playtest](https://docs.xbox.com/ko/tools/xbox-cli/commands/playtest.md)
- [도움말](https://docs.xbox.com/ko/tools/xbox-cli/commands/help.md)
- [패키지](https://docs.xbox.com/ko/tools/xbox-cli/commands/package.md)
