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

# 既知の問題

> XBOX CLI の最新リリースにおける問題と未完成の機能、およびその回避方法について説明します。

このページでは、未完成の機能を含め、XBOX CLI の最新リリースにおける既知の問題を
一覧表示します。問題がここに記載されている場合は、報告する必要はありません。

サポートされるのは最新リリースのみです。[`xbox upgrade`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/upgrade) で、新しいリリースが
利用可能かどうかを確認できます。**修正済み**とマークされた項目は最新リリースで修正されており、次のリリースで
削除されます。

## 問題が記載されていない場合

1. [`xbox upgrade`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/upgrade) で、最新リリースを実行していることを確認します。
2. [既存の Issue](https://github.com/xbox/cli/issues) を検索します。
3. 報告されていない場合は、[`xbox feedback`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/feedback) で報告します。このコマンドは、
   環境の詳細が入力されたバグ レポートを開きます。Issue は公開されるため、公開したくない情報は
   含めないでください。

## CLI の更新

### `xbox upgrade` が HTTP 301 で失敗する

**修正済み**

CLI のパブリック リポジトリが移動したため、v0.2.1 の [`xbox upgrade`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/upgrade) は
毎回 `HTTP 301: GitHub release metadata is unavailable` で失敗します。

**回避策:** [インストール](https://docs.xbox.com/ja-jp/tools/xbox-cli/installation.md)の手順に従って、最新リリースをダウンロードします。

## サインインと権限

### 一部のコマンドが個人用 Microsoft アカウントではまだ動作しない

職場または学校のアカウントではなく個人用 Microsoft アカウントでサインインすると、XBOX サービス構成、
テスト アカウント、パッケージ、プレイテスト、対象ユーザーのコマンドが動作しません。XBOX サービス構成と
テスト アカウントのコマンドは HTTP 502 で失敗し、サービスが利用できないと報告されますが、再試行しても解決しません。

**回避策:** 職場または学校のアカウントでパートナー センターの販売者に参加し、そのアカウントで CLI に
サインインします。

### `xbox game`、`xbox xbl` などのコマンドがまだサービス プリンシパルを受け入れない

サービス プリンシパルはサインインできますが、`audience`、`game`、`package`、`playtest`、`sandbox`、
`seller`、`test-account`、`xbl` コマンドをサービス プリンシパルとして実行すると、承認エラーで失敗します。
これらのコマンドが呼び出すサービスが、まだサービス プリンシパルを受け入れないためです。

**回避策:** これらのコマンドは、サインインしたユーザーとして実行します。`xbox playfab` コマンドは、
ユーザーが [`xbox playfab service-principal set`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/playfab/service-principal) で
アクセス権を付与すれば、サービス プリンシパルで動作します。
[自動化 (サービス プリンシパル) の認証](https://docs.xbox.com/ja-jp/tools/xbox-cli/authentication.md#automation-service-principal-authentication)を参照してください。

### 複数の販売者に所属していると、一部の販売者でコマンドが拒否される

複数のパートナー センターの販売者に所属している場合、XBOX サービス構成、テスト アカウント、パッケージ、
プレイテスト、対象ユーザーのコマンドが、パートナー センターで最後に選択した販売者以外のすべての販売者で
拒否されることがあります。

**回避策:** パートナー センターで目的の販売者を選択してから、コマンドをもう一度実行します。

### `xbox seller list` で販売者の 1 つが表示されないことがある

複数のパートナー センターの販売者に所属している場合、[`xbox seller list`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/seller) で
エラーなしにそのうちの 1 つが表示されないことがあり、次回の実行では表示される場合があります。表示されない間は、
[`xbox audience list`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/audience) など、その販売者に対するコマンドが拒否されることがあり、
パートナー センターでその販売者を選択しても解決するかどうかはわかっていません。

### `xbox game` コマンドが `--seller-id` を無視する

[`xbox game list`、`xbox game get`、`xbox game create`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/game) は、`--seller-id` で渡した販売者や
[コンテキスト](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/context.md)に保存した販売者ではなく、パートナー センターで最後に選択した販売者を
使用します。そのため、`game create` によって別の販売者にゲームが作成される可能性があります。入力ミスなど、
自分のものではない販売者 ID を指定しても失敗せず、自分のゲームが返されます。

**回避策:** パートナー センターで目的の販売者を選択し、ゲームを作成する前に、`xbox game list` に
その販売者のゲームが表示されることを確認します。変更が CLI に反映されるまでに最大 15 分かかる場合があります。

### `xbox sandbox` コマンドでグローバル サンドボックスしか表示されない

`--seller-id` で渡した販売者や[コンテキスト](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/context.md)に保存した販売者が、
パートナー センターで最後に選択した販売者でない場合、
[`xbox sandbox list` と `xbox sandbox get`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/sandbox) は失敗せずに、`CERT`、
`CERT.DEBUG`、`RETAIL` サンドボックスのみを検出します。`xbox sandbox create` は最後に選択した販売者に
サンドボックスを作成し、それが別の販売者である場合は、サンドボックスを読み戻せないため `4` で終了します。
再度作成しないでください。

**回避策:** パートナー センターで目的の販売者を選択してから、その販売者でコマンドをもう一度実行します。
変更が CLI に反映されるまでに最大 15 分かかる場合があります。

## プレイテストと対象ユーザーを使用したテスト

### `xbox audience list` がタイムアウトすることがある

[`xbox audience list`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/audience) は、リクエストがタイムアウトするほど時間がかかることがあります。
`--name` は、すべての対象ユーザーを読み取った後で一覧をフィルター処理するため、効果がありません。

## XBOX サービス構成

### ダウンロードした一部の XML ドキュメントで誤ったエンコードが宣言されている

[`xbox xbl config download --view published`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/xbl) が保存する公開済みの XML ドキュメントの一部
(`mpsdtitleinfo.xml` や `titlename-localization.xml` など) は、`encoding="utf-16"` を宣言していますが、
実際には UTF-8 でエンコードされています。そのため、宣言を信頼する XML リーダーでは読み込みに失敗します。

**回避策:** 解析する前に、ファイルを UTF-8 としてデコードします。

## PlayFab

### `xbox playfab api /Admin/UpdatePolicy` で確認なしにポリシーが上書きされることがある

リクエスト本文に `"OverwritePolicy": true` を指定すると、この呼び出しは、`xbox playfab api-policy set --overwrite` の
安全対策なしに、タイトルの API アクセス ポリシー全体を置き換えます。`--confirm` は必要なく、
保存されたコンテキストまたは `XBOX_PLAYFAB_TITLE_ID` のタイトルを使用することもできます。
誤ったポリシーを設定すると、すべてのプレイヤーがタイトルから締め出される可能性があります。

**回避策:** 代わりに [`xbox playfab api-policy set --overwrite`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/playfab/api-policy) を
使用します。このコマンドでは、`--confirm` と、`--playfab-title-id` で渡したタイトルが必要です。

### `playfab title-data delete` と `playfab player-data delete` が事前に確認を求めない

何かを削除するその他のコマンドは、実行前に確認を求めるか、`--confirm` がない場合は実行を拒否します。この
2 つのコマンドは、指定したキーを直ちに削除します。

### `--keys` と `--member-ids` がコンマ区切りのリストを受け取る

`xbox playfab title-data` と `xbox playfab player-data` の `--keys`、および
[`xbox playfab group member`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/playfab/group) の `--member-ids` は、コンマ区切りのリストを受け取ります。
これらは繰り返し指定するオプションに変更される予定であるため、これらを使用するスクリプトは更新が必要になります。

それまでは、`--keys` でコンマを含むキーを指定することはできません。そのようなキーを読み取るには、名前全体をそのまま受け取る
`--key` で渡しますが、`delete` には `--keys` しかありません。

**回避策:** キーを削除するには、`delete` が使用する API を
[`xbox playfab api`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/playfab/api) で呼び出します。タイトル データの場合は、キーの値を `null` に設定します。
内部タイトル データの場合は、代わりに `/Admin/SetTitleInternalData` を使用します。

```bash theme={null}
xbox --playfab-title-id ABC123 playfab api /Admin/SetTitleData --body '{"Key":"Level,Bonus","Value":null}'
```

プレイヤー データの場合は、[プレイヤー データ](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/playfab/player-data.md)に記載されている、データの
表示設定に応じた更新 API を使用して、`KeysToRemove` にキーを指定します。

```bash theme={null}
xbox --playfab-title-id ABC123 playfab api /Admin/UpdateUserData --body '{"PlayFabId":"PLAYER123","KeysToRemove":["Level,Bonus"]}'
```

## スクリプトとエージェント

### ほとんどのコマンドは、変更が適用されたかどうか不明な場合に 1 で終了する

一部のコマンドは、リクエストの送信後にタイムアウトした場合など、変更が行われたかどうかを判断できない場合に `3` で終了し、
そのことがページに記載されています。PlayFab のすべてのコマンドを含むその他のすべてのコマンドは、どの失敗でも `1` で終了するため、
スクリプトではこのケースと、変更が行われなかったケースを区別できません。

**回避策:** 何かを変更するコマンドが失敗した場合は、もう一度実行する前に現在の状態を確認します。


## Related topics

- [PC 開発向け Unity の概要 (目次)](https://docs.xbox.com/ja-jp/build/gdk-and-engines/unity/unity.md)
- [Playtest の使用](https://docs.xbox.com/ja-jp/publishing/game-publishing/concepts/playtest-preview.md)
- [リリース ノート - XBOX PC Remote Tools (2026 年 3 月)](https://docs.xbox.com/ja-jp/tools/tools-pc/xbox-pc-remote-tools/release-notes/2603.md)
- [Visual Studio 2019 GDK サポート ノート](https://docs.xbox.com/ja-jp/tools/tools-console/visualstudio/vs-2019-support-notes.md)
- [Visual Studio 2019 サポート ノート](https://docs.xbox.com/ja-jp/tools/tools-pc/visualstudio/gr-vs-2019-support-notes.md)
