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

# Connect (xbconnect.exe)

> Connect (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 | 仅显示 System 名称或地址，并使用简单格式。 |
| /T | 仅显示工具的名称或地址，并使用简单格式。 |
| /N | 不尝试连接到目标地址。 |
| /D | 显示已注册的扩展和进程构建信息。 |
| /DX | 运行诊断测试以评估 PC 与 XBOX 开发工具包之间的连接健康状况。有关更多信息，请参阅本主题稍后的 Connect 诊断测试详情部分。 |
| /Q | 仅执行查询，即便提供了地址也不注册默认地址。通常与 **/D** 一起使用，用于直接查询而不影响默认主机设置。 |
| /QG | 查询 Title OS (Game OS) 是否正在运行。仅执行查询，即便提供了地址也不注册默认地址。 **/QG** 通常由脚本使用，用于确定 Title OS 的状态，以选择访问游戏文件的正确方法。在脚本中，如果游戏正在运行则 ERRORLEVEL 设为 0，否则设为 1。有关在脚本中检查 Title OS 状态的示例，请参阅 **在脚本中检查 Title 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** 阻塞，直到 Title OS 已准备好可交互。默认超时为 300 秒，可通过提供一个大致的可选超时值（秒）进行配置（例如：/WTO:200）。使用值 -1 或 'infinite' 无限期等待。 |
| /discover \[search string] | 在局域网中搜索 XBOX 主机，可选择按子字符串进行过滤。搜索字符串适用于主机的主机名，而不是其 IP 地址。 |
| /data | 返回开发 PC 到主机的连接速度（MBps）。 |
| /? | 显示所有可用选项的完整列表。 |
| *address\[+\<accesskey>] \[name]* | *address\[+\<accesskey>]* 指定目标主机的主机名或地址（**Tools IP**）。 • 设置地址会更改默认主机，除非指定了 **/Q** 开关。 • 如果未指定地址，则 **xbconnect** 显示当前存储的默认地址。 • 有关在主机上设置主机名的详情，请参阅[为主机 IP 地址设置主机名](/zh-CN/home/setup-install/dev-kit-settings/setting-a-hostname.md)。 使用 *accesskey* 字符串，只有拥有访问密钥的人员才能访问主机。 • 使用命令 **xbconfig accesskey=your-key** 设置访问密钥，然后重启你的主机以使访问密钥生效。 • 若要访问已配置访问密钥的主机，请在主机 IP 地址或主机名后面加上加号 (+) 和访问密钥。 •  如果通过 **xbconnect** 设置默认主机时提供了访问密钥，则该访问密钥会作为默认主机地址的一部分存储。 •  有关访问密钥的更多信息，请参阅 [xbconfig accesskey](/zh-CN/tools/tools-console/commandlinetools/xbconfig.md)。 使用 *name* 指定要与地址关联的名称。如果未指定名称，则 **xbconnect** 使用 “devkit” 作为主机标识符。开发工具用来连接到主机的 *address* 在主机上显示为 **Console IP**。 •  如果未指定 *address* 且未设置默认地址，则 **xbconnect** 显示错误消息。 •  如果未指定 *address* 但已设置默认地址，则 **xbconnect** 尝试连接到默认主机地址。这可用于验证默认主机仍可访问。 •  在调用其他远程工具时，你可以使用 **/X** 开关指定开发工具包以覆盖默认主机地址。 |
| /LC | 指定区域设置代码，用于覆盖默认的区域设置代码 |

## 在脚本中检查 Title 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 上本地以及开发主机上运行多种测试，以确定可能导致连接问题的原因。这些测试分为四组，每组中运行不同类别的测试。失败以红色显示，附带错误代码及描述该错误代码的一些详细文本。此外，某些测试还会显示可能对故障排除有用的更多数据。

### 本地 PC 测试

本地 PC 测试在你的开发 PC 上运行，与开发主机无关。
进程运行：测试为了能与 XBOX 开发主机协同工作，应该正在运行的进程。测试的进程包括：

* XbtpLinkSvc.exe
* XrfsSvc.exe
  > [!NOTE]
  >
  > 该特定进程可能未启动，这并不一定是真正的失败。

### PC 到主机测试

PC 到主机测试从开发 PC 发起，并尝试以各种方式连接到开发主机。

* **XbtpLink：** 测试 PC 与主机之间的 XBTP 协议是否正常工作，可通过传输控制协议 (TCP) 或使用 XBOX Transfer Device (XTD)。
* **Query IP：** 请求主机返回其已知的 IP 地址。
* **Ping：** 尝试使用标准 Internet 控制消息协议 (ICMP) 对提供的 IP 地址的目标主机执行 ping 操作。
* **Port connections：** 尝试连接到开发主机上运行服务的开放端口。这些服务和端口包括：
  * XTF (XBOX Tools Framework)：端口 4201/4211/4221
  * VS Debugger (Visual Studio Remote Debugger)：端口 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)

## 另请参阅

[命令行工具](/zh-CN/tools/tools-console/commandlinetools/commandlinetools.md)

[文件复制 (xbcp.exe)](/zh-CN/tools/tools-console/commandlinetools/xbcp.md)

[目录 (xbdir.exe)](/zh-CN/tools/tools-console/commandlinetools/xbdir.md)

[诊断信息 (xbdiaginfo.exe)](/zh-CN/tools/tools-console/commandlinetools/xbdiaginfo.md)


## Related topics

- [目录 (xbdir.exe)](/zh-CN/tools/tools-console/commandlinetools/xbdir.md)
- [预配 (xbprovision.exe)](/zh-CN/tools/tools-console/commandlinetools/xbprovision.md)
- [重启 (xbreboot.exe)](/zh-CN/tools/tools-console/commandlinetools/xbreboot.md)
- [删除目录 (xbrmdir.exe)](/zh-CN/tools/tools-console/commandlinetools/xbrmdir.md)
- [文件删除 (xbdel.exe)](/zh-CN/tools/tools-console/commandlinetools/xbdel.md)