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

# PC

> XblPCSandbox.exe と同様に、この Windows PC が使用する XBOX サンドボックスを取得または切り替えます。

`pc` コマンドは、この Windows PC が使用する XBOX サンドボックスを取得または切り替えます。これらのコマンドは
試験段階 (Experimental) であり、Windows でのみ実行されます。
[試験段階のコマンド](https://docs.xbox.com/ja-jp/tools/xbox-cli/cli-command-lifecycle.md)を参照してください。

PC は一度に 1 つのサンドボックスを、その PC 上のすべてのユーザーとすべてのゲームに対して使用し、ゲームはそのサンドボックスに
サインインします。既定値は `RETAIL` です。`ABCDEF.1` などの開発用サンドボックスでゲームをテストするには、
最初に PC をそのサンドボックスに切り替えます。パートナー センター アカウントにあるサンドボックスを確認するには、
[`xbox sandbox list`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/sandbox) を使用します。

## コマンド

各コマンドは、XBOX サービスの PC サンドボックス スイッチャーである `XblPCSandbox.exe` を実行し、
[そのドキュメント](https://learn.microsoft.com/gaming/gdk/docs/tools/tools-services/live-pc-sandbox-switcher)に
記載されているとおりに動作します。

| コマンド | 同等のコマンド | 説明 |
| - | - | - |
| `pc sandbox get` | `XblPCSandbox /get` | この PC が使用するサンドボックスを取得します。 |
| `pc sandbox set <sandbox-id>` | `XblPCSandbox /set <sandbox-id>` または `/retail` | この PC をサンドボックスに切り替えるか、`RETAIL` に戻します。 |
| `pc sandbox launch-apps` | `XblPCSandbox /launchApps` | Microsoft Store と XBOX アプリを閉じ、この PC のサンドボックスで再度開きます。 |

ツールの `/feedback` コマンドを使用するには、`XblPCSandbox /feedback` を直接実行します。

## サンドボックスの切り替え

```bash theme={null}
xbox pc sandbox set ABCDEF.1 --confirm
```

`pc sandbox set` は、PC 上のすべてのユーザーのサンドボックスを変更します。切り替える前に確認を求め、その後、
管理者権限を求めるユーザー アカウント制御 (UAC) のプロンプトを表示します。PC 上の XBOX サービスを再起動し、
Microsoft Store と XBOX アプリが開いていた場合は再度開きます。その後、PC が新しいサンドボックスを
使用していることを確認します。

`set` は、PC が既にそのサンドボックスを使用している場合でも切り替えを行います。再度実行するとサービスが再起動されるため、
サインインが引き続き古いサンドボックスを使用している問題が解決されます。それでも解決しない場合は、PC を再起動し、
[サンドボックスのトラブルシューティング](https://aka.ms/XboxLiveSandboxHelp)を参照してください。

Microsoft Store から XBOX アプリまたは Gaming Services をアップデートする前に、`RETAIL` に切り替えてください。

## ツールのインストール

`XblPCSandbox.exe` は、XBOX Game Development Kit (GDK) に含まれているほか、
[XBOX サービス開発ツールのリリース](https://github.com/microsoft/xbox-live-developer-tools/releases) ページの
`XboxLiveTools.zip` にも含まれています。PC で XBOX の機能を実行する Windows サービスである Gaming Services がインストールされている必要があります。
CLI は次の順序でツールを検索します。

1. `XBOX_XBLPCSANDBOX__PATH` 環境変数などの `XblPCSandbox:Path` 設定。
2. CLI を含むフォルダー。
3. `PATH` 上の各フォルダー。

## オプション

| オプション | コマンド | 説明 |
| - | - | - |
| `--confirm`、`--yes`、`-y` | `set` | 確認プロンプトなしで切り替えます。対話型ターミナル以外では必須です。 |
| `--no-apps` | `set` | ツールの `/noApps` と同様に、Microsoft Store と XBOX アプリを再度開きません。後で `launch-apps` を実行して再度開きます。 |
| `--output <format>` | すべて | `json` (既定)、`json-compact`、または `table`。 |

## 出力

`get` と `launch-apps` は `{"sandbox": "ABCDEF.1"}` を返し、`set` は
`{"sandbox": "ABCDEF.1", "previousSandbox": "RETAIL"}` を返します。`--output table` を指定した場合の列は
`SANDBOX` と、`set` の場合は `PREVIOUS SANDBOX` です。ツール自体の出力は stderr に出力されます。

## エラー

| 原因 | 結果 |
| - | - |
| UAC のプロンプトが拒否された | サンドボックスは変更されません。 |
| Gaming Services がない、または動作していない | ツールの出力に原因が示され、エラーには Gaming Services 修復ツールへのリンクが含まれます。 |
| 切り替えが反映されなかった | ツールは成功を報告しましたが、PC は別のサンドボックスを使用しています。切り替えを再度実行し、それでも失敗する場合は PC を再起動します。 |
| ツールが見つからなかった | CLI が検索した場所とツールのインストール方法がエラーに示されます。 |
| Ctrl+C キーを押した | CLI はツールを停止します。UAC のプロンプトを承認していた場合は、切り替えが完了する可能性があります。`xbox pc sandbox get` で確認してください。 |

ツールのエラーには [サンドボックスのトラブルシューティング](https://aka.ms/XboxLiveSandboxHelp)へのリンクが含まれ、
問題を報告するために `XblPCSandbox /feedback` が提案されます。

## 例

この PC が使用するサンドボックスを取得します。

```bash theme={null}
xbox pc sandbox get
```

Microsoft Store と XBOX アプリを再度開かずに開発用サンドボックスに切り替えてから、それらを再度
開きます。

```bash theme={null}
xbox pc sandbox set ABCDEF.1 --confirm --no-apps
xbox pc sandbox launch-apps
```

`RETAIL` に戻します。

```bash theme={null}
xbox pc sandbox set RETAIL --confirm
```


## Related topics

- [XBOX PC Remote Tools](https://docs.xbox.com/ja-jp/tools/tools-pc/xbox-pc-remote-tools/index.md)
- [Windows PC 上の Fiddler](https://docs.xbox.com/ja-jp/build/console-features/networking/tools/fiddler-pc.md)
- [XBOX PC Remote Iteration API](https://docs.xbox.com/ja-jp/reference/remoting/remoteiteration_members.md)
- [PC ゲームの登録](https://docs.xbox.com/ja-jp/tools/tools-pc/title-registration-pc.md)
- [PC 開発者向け FAQ](https://docs.xbox.com/ja-jp/build/gdk-and-engines/guides/pc-faq.md)
