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

# 重启 (xbreboot.exe)

> 重启 (xbreboot.exe)

使用此工具重启或关闭远程主机。

| 列 1 |
| - |
| **xbreboot** \[/S] \[/T:\<*Number of Hours*>] \[/P\[:]\[*MAC address*]] \[/Q\[:]\[MAC address]] \[/W\[:]\[*MAC address*]] \[/X\[\[:]*address*\[*+\<accesskey>*]] |

| 选项 | 说明 |
| - | - |
| /S | 指定完全关闭开发工具包,而不是重启。 |
| /T:\<*Number of Hours*> | 与 /S 结合使用,该选项指定在再次开启主机之前等待的小时数。 |
| /P\[:]\[*MAC address*] | 使主机进入*连接待机*状态。需要将开发工具包的电源模式设置为“Instant On”。 |
| /W\[:]\[*device ID or MAC address*] | 尝试将开发工具包从连接待机状态唤醒。 |
| /Q\[:]\[*MAC address*] | 查询主机是否处于连接待机状态、电源模式是否设置为支持 Instant On,以及主机是否允许远程开机连接。 |
| /X\[:]*address\[+\<accesskey>]* | - 使用此选项可指定目标主机的主机名或地址(在主机上显示为 **Tools IP**),而不更改默认主机。有关为主机设置主机名的详细信息,请参阅[为主机 IP 地址设置主机名](/zh-CN/home/setup-install/dev-kit-settings/setting-a-hostname)。 -  如果不使用此选项,则使用默认主机(先前由 [Connect (xbconnect.exe)](/zh-CN/tools/tools-console/commandlinetools/xbconnect) 设置)。 - 使用 *accesskey* 字符串仅向持有访问密钥的人员提供主机访问权限。 - 通过命令 **xbconfig** **accesskey=your-key** 设置访问密钥,然后重启主机使访问密钥生效。 - 若要访问配置了访问密钥的主机,请在主机的 IP 地址或主机名后加上加号 (+) 和访问密钥。 - 如果在通过 [xbconnect](/zh-CN/tools/tools-console/commandlinetools/xbconnect) 设置默认主机时提供了访问密钥,则该访问密钥将作为默认主机地址的一部分存储。 - 有关访问密钥的详细信息,请参阅 [xbconfig accesskey](/zh-CN/tools/tools-console/commandlinetools/xbconfig)。 |
| /LC | 指定区域设置代码。用于覆盖默认的区域设置代码。 |

## 备注

**xbreboot** 工具始终执行冷启动。如果只想终止正在运行的标题(比重启快得多),请使用 **xbapp terminate pkg\_full\_name**。无论应用当前处于哪种状态(正在运行、挂起或其他),此命令都有效。有关详细信息,请参阅[应用程序管理 (xbapp.exe)](/zh-CN/tools/tools-console/commandlinetools/xbapp)。

### 定时开关机

许多 XBOX 开发工具包(既包括自动化实验室中的,也包括开发人员桌面上的)为了可远程访问,常常 24×7 保持开启状态。近两年来,远程工作日益普及,这种情况愈加常见。即使处于闲置状态,这些设备也会消耗 30 瓦以上的功率。由于这些开发工具包通常只在工作周的特定时段使用,大部分时间处于闲置状态,不必要地浪费能源。从 2022 年 6 月的 GDK 开始,我们为 “Xbreboot /S” 新增了一个 “/T:\<time in hours>” 标志,允许开发人员将主机关机(节能模式,大约消耗 0.5 瓦)一段用户指定的小时数,然后自动重新开机。可以手动调用此命令,例如在一天工作结束前执行 “XbReboot /S /T:14”,但我们建议使用 Windows 内置的任务计划程序(或其他定时任务系统)设置工作时段,在此期间开发工具包通电,其余时间关机。

我们提供了一些 schtasks.exe 的示例命令行调用,用于在 Windows 任务计划程序中创建任务(创建后可通过任务计划程序 UI 进一步修改)。这些命令行应根据个人的工作时间进行修改,以包含所需主机的 IP 地址或主机名,并更改开始时间和小时数。

**周一至周四任务:**

schtasks /create /tn "Weekday Console Shutdown of console \<IP Address or hostname> from 6pm - 8am" /tr ""C:\Program Files (x86)\Microsoft GDK\bin\XbReboot.exe" /x:\<IP Address or hostname> /S /T:14" /sc weekly /d MON,TUE,WED,THU /st 18:00

**周五晚的任务,让主机在整个周末保持关机:**

schtasks /create /tn "Weekend Console Shutdown of console \<IP Address or hostname> 6pm Friday - 8am Monday" /tr ""C:\Program Files (x86)\Microsoft GDK\bin\XbReboot.exe" /x:\<IP Address or hostname> /S /T:62" /sc weekly /d FRI /st 18:00

有关远程使用 **xbreboot** 的信息,请参阅[远程使用 GDK](/zh-CN/build/console-features/console-workflows/using-gdk-remotely)。

## 另请参阅

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

[XTF 传输错误](/zh-CN/tools/tools-console/commandlinetools/xtf-transport-errors)

[Connect (xbconnect.exe)](/zh-CN/tools/tools-console/commandlinetools/xbconnect)


## Related topics

- [仅通过向后兼容支持的跨世代游戏](/zh-CN/build/console-features/cross-gen/cross-gen-backcompat-only.md)
- [面向主机开发的命令行工具](/zh-CN/tools/tools-console/commandlinetools/commandlinetools.md)
- [命令行工具](/zh-CN/tools/tools-console/commandlinetools/index.md)
- [设置沙盒](/zh-CN/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes.md)
- [QueryConnectedStandby](/zh-CN/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_queryconnectedstandby.md)
