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

# 升級

> 檢查是否有較新的 CLI 穩定版本，並取得手動更新的指示。

`xbox upgrade` 會檢查 GitHub 上是否有較新的穩定版本，如果有，就會告訴您如何安裝它。它不會下載或安裝任何內容，而且您不需要登入。

```bash theme={null}
xbox upgrade
```

## 選項

| 選項 | 描述 |
| - | - |
| `--check` | 檢查是否有較新的版本。這是預設值，因此 `xbox upgrade` 和 `xbox upgrade --check` 的作用相同。 |
| `--output <format>` | `json` (預設) 或 `json-compact`。無法使用 `table`。 |

由於不會安裝任何內容，因此會拒絕 `--confirm` (`--yes`、`-y`)。

## 結果

成功的檢查會將一個 JSON 物件寫入 stdout：

| 欄位 | 描述 |
| - | - |
| `schemaVersion` | `1`。 |
| `currentVersion` | 執行中的版本，與 `xbox --version` 顯示的版本相同。 |
| `latestVersion` | 最新的穩定版本，不含開頭的 `v`。 |
| `updateAvailable` | 當最新的穩定版本比執行中的版本還新時為 `true`。 |
| `releaseNotesUrl` | 該版本在 GitHub 上的頁面。 |
| `message` | 供人員閱讀的摘要。 |
| `instructions` | 當 `updateAvailable` 為 `true` 時，說明如何更新；否則為空陣列。 |

```bash theme={null}
xbox upgrade --output json-compact
```

```json theme={null}
{"schemaVersion":1,"currentVersion":"1.2.0","latestVersion":"1.3.0","updateAvailable":true,"releaseNotesUrl":"https://github.com/xbox/cli/releases/tag/v1.3.0","message":"A newer stable XBOX CLI release is available. Update manually using the instructions below.","instructions":["..."]}
```

若要安裝更新，請參閱[更新 ZIP 安裝](https://docs.xbox.com/zh-TW/tools/xbox-cli/installation.md#update-a-zip-installation)，若使用 WinGet，請參閱 [Windows：使用 WinGet 安裝](https://docs.xbox.com/zh-TW/tools/xbox-cli/installation.md#windows-install-with-winget)。版本在 GitHub 上出現後，可能要過幾個小時才會出現在 WinGet 上，因此 `winget upgrade` 可能尚未提供該版本。

## 結束代碼

| 結束代碼 | 意義 |
| - | - |
| `0` | 檢查成功，無論是否有可用的更新。請讀取 `updateAvailable`。 |
| `1` | 檢查失敗，且 stdout 為空白。 |

檢查不會登入 GitHub。HTTP 404 表示找不到公開的穩定版本，而 HTTP 403 或 429 表示 GitHub 拒絕了要求或對要求進行速率限制。無論哪種情況，請改為在瀏覽器中開啟[版本頁面](https://github.com/xbox/cli/releases)。


## Related topics

- [帳戶方案升級](https://docs.xbox.com/zh-TW/services/playfab/pricing/account-upgrades.md)
- [實體 API 重新架構升級教學課程](https://docs.xbox.com/zh-TW/services/playfab/live-service-management/game-configuration/entities/entity-api-restructure-upgrade-tutorial.md)
- [Visual Studio 2019 GDK 支援注意事項](https://docs.xbox.com/zh-TW/tools/tools-console/visualstudio/vs-2019-support-notes.md)
- [Visual Studio 2019 支援注意事項](https://docs.xbox.com/zh-TW/tools/tools-pc/visualstudio/gr-vs-2019-support-notes.md)
- [PlayFab 2016 年版本資訊](https://docs.xbox.com/zh-TW/announcements/playfab/2016.md)
