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

# 预配 (xbprovision.exe)

> 预配 (xbprovision.exe)

使用此工具管理主机上预配的 Game OS 文件,并在主机上执行自定义预配。

| 列 1 |
| - |
| \*\*xbprovision \*\**command* \[/X\[:]*address\[+\<accesskey>]*] |

| 选项 | 说明 |
| - | - |
| *command* | 指定要执行的预配命令。此选项支持下表所示的命令。 **add \[filepath] /fallback** - 将 \[filepath] 指定的 Game OS 添加到主机上的缓存 **remove \[four\_part\_version] \[/f]** - 从主机上的缓存中移除由 \[four\_part\_version]\(例如 10.0.18230.1003)指定的 Game OS **list** - 按四段式版本号列出主机上当前缓存的所有 Game OS 版本 |
| /F | 可选标志,用于强制执行移除操作。如果缓存文件正在使用,则可能会终止正在运行的标题。 |
| /fallback | 可选标志,用于添加或替换回退 Game OS,而不是将该 Game OS 添加到常规缓存中。这会自动重启主机以使其生效。 |
| /X\[:]*address\[+\<accesskey>]\[/title]* | - 使用此选项可指定目标主机的主机名或地址(在主机上显示为 **Tools IP**),而不更改默认主机。有关为主机设置主机名的详细信息,请参阅[为主机 IP 地址设置主机名](/zh-CN/home/setup-install/dev-kit-settings/setting-a-hostname.md)。 - 如果不使用此选项,则使用默认主机(先前由 [Connect (xbconnect.exe)](/zh-CN/tools/tools-console/commandlinetools/xbconnect.md) 设置)。 - 使用 *accesskey* 字符串仅向持有访问密钥的人员提供主机访问权限。  通过命令 **xbconfig** **accesskey=your-key** 设置访问密钥,然后重启主机使访问密钥生效。 - 若要访问配置了访问密钥的主机,请在主机的 IP 地址或主机名后加上加号 (+) 和访问密钥。 - 如果在通过 [xbconnect](/zh-CN/tools/tools-console/commandlinetools/xbconnect.md) 设置默认主机时提供了访问密钥,则该访问密钥将作为默认主机地址的一部分存储。 - 有关访问密钥的详细信息,请参阅 [xbconfig accesskey](/zh-CN/tools/tools-console/commandlinetools/xbconfig.md)。 |
| /LC | 指定区域设置代码。用于覆盖默认的区域设置代码。 |

## 另请参阅

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

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

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


## Related topics

- [FourPartVersion](/zh-CN/reference/tools/xtf/xtfapi/structs/fourpartversion-xtfapi-xbox-windows-s.md)
- [XtfRemoveTitleOSFromCache](/zh-CN/reference/tools/xtf/xtfapi/functions/xtfremovetitleosfromcache-xtfapi-xbox-windows-m.md)
- [XtfRemoveTitleOSFromCacheByVersion](/zh-CN/reference/tools/xtf/xtfapi/functions/xtfremovetitleosfromcachebyversion-xtfapi-xbox-windows-m.md)
- [XtfStartTitleOS](/zh-CN/reference/tools/xtf/xtfapi/functions/xtfstarttitleos-xtfapi-xbox-windows-m.md)
- [XtfStartTitleOSByVersion](/zh-CN/reference/tools/xtf/xtfapi/functions/xtfstarttitleosbyversion-xtfapi-xbox-windows-m.md)