> ## 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`) は拒否されます。

## 結果

確認が成功すると、1 つの 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/ja-jp/tools/xbox-cli/installation.md#update-a-zip-installation)を参照してください。
WinGet の場合は、[Windows: WinGet でインストールする](https://docs.xbox.com/ja-jp/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/ja-jp/services/playfab/pricing/account-upgrades.md)
- [エンティティ API 再構成アップグレード チュートリアル](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/game-configuration/entities/entity-api-restructure-upgrade-tutorial.md)
- [PlayFab リリースノート 2017](https://docs.xbox.com/ja-jp/services/playfab/release-notes/2017.md)
- [PlayFab リリース ノート 2017](https://docs.xbox.com/ja-jp/announcements/playfab/2017.md)
- [Visual Studio 2019 サポート ノート](https://docs.xbox.com/ja-jp/tools/tools-pc/visualstudio/gr-vs-2019-support-notes.md)
