> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 接続 (xbconnect.exe)

> 接続 (xbconnect.exe)

このツールを使用して、Microsoft Game Development Kit (GDK) のリモート ツールで使用される既定のコンソールのアドレスを設定または照会します。

| Column 1 |
| - |
| **xbconnect** \[/B] \[/S] \[/T] \[/N] \[/D] \[/Q] \[/QG] \[/WS\[:sec] ] \[/WTP\[:sec] ] \[/WT\[:sec] ] \[/WTO\[:sec] ] \[/discover \[search string] ] \[/data] \[/?] \[*address\[+\<accesskey>] \[name]*] |

| オプション | 説明 |
| - | - |
| /B | コンソールの名前またはアドレスのみを表示し、ベア形式を使用します。 |
| /S | システム名またはアドレスのみを表示し、ベア形式を使用します。 |
| /T | ツールの名前またはアドレスのみを表示し、ベア形式を使用します。 |
| /N | ターゲット アドレスへの接続を試みません。 |
| /D | 登録された拡張機能とプロセス ビルド情報を表示します。 |
| /DX | PC と XBOX 開発キット間の接続状態を評価する診断テストを実行します。詳細については、このトピックの後半にある「Connect 診断テストの詳細」セクションを参照してください。 |
| /Q | 照会のみを実行し、アドレスが指定されていても既定のアドレスを登録しません。通常は既定のコンソール設定に影響を与えずに直接照会するために **/D** と共に使用されます。 |
| /QG | タイトル OS (Game OS) が実行中かどうかを照会します。照会のみを実行し、アドレスが指定されていても既定のアドレスを登録しません。 **/QG** は通常、タイトルのファイルにアクセスする正しい方法を選択するために、タイトル OS の状態を判断するスクリプトで使用されます。スクリプトでは、タイトルが実行中の場合は ERRORLEVEL が 0 に設定されます。そうでない場合は 1 に設定されます。スクリプト内でタイトル OS の状態を確認する例については、「スクリプトでのタイトル OS の状態確認」セクションを参照してください。 |
| /WS\[:sec] |  • **xbconnect** をブロックして System OS が対話できる状態になるかタイムアウトに達するまで待機します。 • 既定のタイムアウトは 120 秒です。**xbconnect /WS:200** のようにカスタム値を指定するオプションがあります。 • コンソールが準備完了の場合は ERRORLEVEL=0 を、タイムアウトに達した場合は ERRORLEVEL=1 を返します。 • **xbreboot** の後に **xbapp launch** を呼び出せるようになるタイミングなど、コンソールがコマンドを受け入れる準備ができたタイミングを判断する信頼できる方法を提供します。 • 無限に待機するには、-1 または "infinite" を使用します。 |
| /WTP\[:sec] |  • **xbconnect** をブロックしてタイトル プロセスが対話できる状態になるまで待機します。既定のタイムアウトは 300 秒で、秒単位のオプションのタイムアウト値を指定して構成できます (例: /WTP:200)。無限に待機するには -1 または 'infinite' を使用します。 |
| /WT\[:sec] |  • **xbconnect** をブロックして Game OS が対話できる状態になるかタイムアウトに達するまで待機します。 • 既定のタイムアウトは 120 秒です。**xbconnect /WT:200** のようにカスタム値を指定するオプションがあります。 • コンソールが準備完了の場合は ERRORLEVEL=0 を、タイムアウトに達した場合は ERRORLEVEL=1 を返します。 • Game OS が初期化を完了しゲームが開始されたタイミングを判断する信頼できる方法を提供します。 • 無限に待機するには、-1 または "infinite" を使用します。 |
| /WTO\[:sec] |  • **xbconnect** をブロックしてタイトル OS が対話できる状態になるまで待機します。既定のタイムアウトは 300 秒で、秒単位のオプションのタイムアウト値を指定して構成できます (例: /WTO:200)。無限に待機するには -1 または 'infinite' を使用します。 |
| /discover \[search string] | 省略可能な部分文字列でフィルターして、LAN 上の XBOX コンソールを検索します。検索文字列は、コンソールのホスト名に対して適用され、IP アドレスに対しては適用されません。 |
| /data | 開発 PC からコンソールへの接続速度を MBps で返します。 |
| /? | 使用可能なオプションの完全な一覧を表示します。 |
| *address\[+\<accesskey>] \[name]* | *address\[+\<accesskey>]* は、対象コンソールのホスト名またはアドレス (**\[ツール IP]**) を指定します。 • アドレスを設定すると、**/Q** スイッチが指定されない限り、既定のコンソールが変更されます。 • アドレスが指定されていない場合、**xbconnect** は現在保存されている既定のアドレスを表示します。 • コンソールのホスト名の設定については、[コンソールの IP アドレスにホスト名を設定する](/ja-jp/home/setup-install/dev-kit-settings/setting-a-hostname)を参照してください。 *accesskey* 文字列を使用して、アクセス キーを持っている人だけにコンソールへのアクセスを提供します。 • コマンド **xbconfig accesskey=your-key** を使用してアクセス キーを設定し、その後コンソールを再起動してアクセス キーを有効にします。 • アクセス キーで構成されたコンソールにアクセスするには、コンソールの IP アドレスまたはホスト名の後にプラス記号 (+) とアクセス キーを含めます。 • **xbconnect** で既定のコンソールを設定するときにアクセス キーが指定されている場合、アクセス キーは既定のコンソールのアドレスの一部として保存されます。 • アクセス キーの詳細については、[xbconfig accesskey](/ja-jp/tools/tools-console/commandlinetools/xbconfig) を参照してください。 *name* を使用して、アドレスに関連付ける名前を指定します。名前が指定されていない場合、**xbconnect** はコンソール識別子として "devkit" を使用します。開発ツールがコンソールへの接続に使用する *address* は、コンソールに **\[コンソール IP]** として表示されます。 • *address* が指定されておらず、既定のアドレスも設定されていない場合、**xbconnect** はエラー メッセージを表示します。 • *address* が指定されておらず、既定のアドレスが設定されている場合、**xbconnect** は既定のコンソールのアドレスへの接続を試みます。既定のコンソールがまだアクセス可能かを確認するために使用できます。 • 他のリモート ツールを呼び出すときに、**/X** スイッチを使用して開発キットを指定することで、既定のコンソールのアドレスをオーバーライドできます。 |
| /LC | ロケール コードを指定します。既定のロケール コードをオーバーライドするために使用します。 |

## スクリプトでのタイトル OS の状態確認

```
@xbconnect /QG > nul
@if ERRORLEVEL=1 GOTO SYSTEM

@echo Title running
@echo using xbcp
@GOTO ENDD

@:SYSTEM
@echo Title not running
@echo using robocopy 
@GOTO ENDD

@:ENDD
@echo Done
```

スクリプトを実行すると、次のような出力が生成されます。

```
C:\Scratch\D\GXDK\SigninUser\temp>testqg.bat
Title not running
using robocopy
Done
C:\Scratch\D\GXDK\SigninUser\temp>testqg.bat
Title running
using xbcp
Done  
```

## Connect 診断テストの詳細

**xbconnect /dx** (診断) は、接続の問題の原因を特定するために、開発 PC と開発コンソールの両方でさまざまなテストを実行します。これらのテストは 4 つのグループに分かれており、各グループでカテゴリ別のテストが実行されます。失敗は赤色で表示され、エラー コードとエラー コードをより詳しく説明するテキストが表示されます。さらに、一部のテストではトラブルシューティングに役立つデータも表示されます。

### ローカル PC テスト

ローカル PC テストは開発 PC 上で実行され、開発コンソールに依存しません。
プロセスの実行: XBOX 開発コンソールで作業するために実行する必要のあるプロセスをテストします。テストされるプロセスには次のものが含まれます。

* XbtpLinkSvc.exe
* XrfsSvc.exe
  > [!NOTE]
  >
  > この特定のプロセスは開始されていない場合があり、必ずしも真の失敗ではありません。

### PC からコンソールへのテスト

PC からコンソールへのテストは、開発 PC で開始され、さまざまな方法で開発コンソールへの接続を試みます。

* **XbtpLink:** PC とコンソール間で XBTP プロトコルが Transmission Control Protocol (TCP) 経由または XBOX Transfer Device (XTD) を使用して動作していることをテストします。
* **Query IP:** コンソールに、知られている IP アドレスを返すように要求します。
* **Ping:** 標準のインターネット制御メッセージ プロトコル (ICMP) を使用して、提供された IP アドレスでターゲット コンソールに対する ping を試みます。
* **ポート接続:** 開発コンソール上でサービスが実行されている開いたポートへの接続を試みます。これらのサービスとポートには次のものが含まれます。
  * XTF (XBOX Tools Framework): ポート 4201/4211/4221
  * VS Debugger (Visual Studio リモート デバッガー): ポート 4024/4022/4020/4016
  * Video Server (XBOX Manager で使用されるリモート ビデオ サーバー): ポート 11442
  * WDP (Windows Device Portal for XBOX): ポート 11443

### コンソール テスト

コンソール テストはリモート コンソール上で実行され、開発 PC に依存しません。

* **Debug NIC:** リテール ネットワーク ポートに加えて、コンソール上のデバッグ ネットワーク ポートが使用されているかを判断します。
* **プロセスの実行:** 開発コンソール上で実行する必要のあるプロセスをテストします。これらのプロセスには Xtfhost.exe が含まれます。

### コンソールから PC へのテスト

コンソールから PC へのテストは、開発コンソールで開始され、さまざまな方法で開発 PC への接続を試みます。

* **Ping:** PC によって提供された IP アドレスを使用して、対象の開発 PC に対する ping を試みます。
  > [!NOTE]
  >
  > PC 上のすべてのルート可能なアドレスに試行されますが、すべてのアドレスが XBOX 開発コンソールからルート可能であるとは限りません。このテストで特定のアドレスが失敗することは珍しくありません。
* **XbtpLink:** 開発 PC と開発コンソール間で XBTP プロトコルが TCP 経由または XTD を使用して動作していることをテストします。

### 診断出力の例

診断出力の例を次のスクリーンショットに示します。

![xbconnect 診断のスクリーンショット](https://mintcdn.com/microsoft-4404708b/0AcfaOdKrAaDPaQZ/images/gdk/tools/xbconnect_diagnostics.webp?fit=max\&auto=format\&n=0AcfaOdKrAaDPaQZ\&q=85\&s=fb112edebb182f6653147f82914d91f7)

## 関連項目

[コマンド ライン ツール](/ja-jp/tools/tools-console/commandlinetools/commandlinetools)

[ファイル コピー (xbcp.exe)](/ja-jp/tools/tools-console/commandlinetools/xbcp)

[ディレクトリ (xbdir.exe)](/ja-jp/tools/tools-console/commandlinetools/xbdir)

[診断情報 (xbdiaginfo.exe)](/ja-jp/tools/tools-console/commandlinetools/xbdiaginfo)


## Related topics

- [再起動 (xbreboot.exe)](/ja-jp/tools/tools-console/commandlinetools/xbreboot.md)
- [リモート リカバリー (xbremoterecovery.exe)](/ja-jp/tools/tools-console/commandlinetools/xbremoterecovery.md)
- [ファイル コピー (xbcp.exe)](/ja-jp/tools/tools-console/commandlinetools/xbcp.md)
- [ゲーム ストリーミングの管理 (xbgamestream.exe)](/ja-jp/tools/tools-console/commandlinetools/xbgamestream.md)
- [画面キャプチャ ツール (xbcapture.exe)](/ja-jp/tools/tools-console/commandlinetools/xbcapture.md)