> ## 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 的輸入、結束代碼，以及它所加入的輸出 (例如 `--data-only` 會移除的回應信封) 仍在涵蓋範圍內。

## 實驗性

實驗性命令的發行目的是取得對其介面的意見反應。即使在 1.0 之後，其路徑、選項、預設值、輸出和行為仍可能變更，或命令可能被移除，因此不要依賴使用這些命令的自動化會維持相容。

實驗性命令已完成且經過測試，並遵循與其他所有命令相同的安全性和安全規則，包括在破壞性作業之前要求確認。它們的執行方式與其他命令相同；您不需要開啟它們。


## Related topics

- [命令](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands.md)
- [說明](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/help.md)
- [套件](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/package.md)
- [Playtest](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/playtest.md)
- [PC](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/pc.md)
