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

# 更新主机映射 (XbUpdateHosts.exe)

> 更新主机映射 (XbUpdateHosts.exe)

使用此工具在 XBOX 开发工具包上将指定的主机/域名映射到指定的 IP 地址。在居家办公环境下开发时,名称解析问题变得更为常见。**XbUpdateHosts** 会为特定主机/域名提供特定的 IP 地址,从而覆盖 XBOX 开发工具包通常解析该名称的方式。此工具需要用户输入(用于在 XBOX 开发工具包上配置 HOSTS 文件),并未作为解决名称解析问题的自动方案对外公开。

在使用“从 PC 运行”部署时,名称解析问题最为常见。有关 **XbUpdateHosts** 与“从 PC 运行”部署一起使用的详细信息,请参阅本主题稍后的 [XbUpdateHosts 与“从 PC 运行”一起使用](#XbUpdateHosts_RfPC)。

## 命令行格式

```
xbupdatehosts [command-independent-options] <command> [command-specific-options]
```

## 命令行用法

| 命令 | 说明 |
| - | - |
| [xbupdatehosts add](#XbUpdateHosts_Add) | 将提供的主机名映射添加或替换到主机上 |
| [xbupdatehosts remove](#XbUpdateHosts_Remove) | 从主机中删除提供的主机名映射 |
| [xbupdatehosts list](#XbUpdateHosts_List) | 列出存储在主机上的所有主机名映射 |
| [xbupdatehosts backup](#XbUpdateHosts_Backup) | 创建存储在主机上的所有主机名映射的备份 |
| [xbupdatehosts restore](#XbUpdateHosts_Restore) | 从文件中将所有主机名映射还原到主机上 |
| [xbupdatehosts examples /?](#XbUpdateHosts_Examples) | 列出 **XbUpdateHosts** 中常用命令的示例用法 |
| [xbupdatehosts commands /?](#XbUpdateHosts_Usage) | 列出 **XbUpdateHosts** 的所有可用命令 |
| [xbupdatehosts `<command>` /?](#XbUpdateHosts_Usage) | 列出 **XbUpdateHosts** 中特定命令的帮助信息 |
| /LC | 指定区域设置代码。用于覆盖默认的区域设置代码。 |

### XbUpdateHosts add

将提供的主机名映射添加或替换到主机上。

#### 用法

**xbupdatehosts add \<*target host name*> \<*IP address*>**

主机名可以指定为 @auto,以使用开发 PC 的主机名和完全限定域名。

IP 地址参数可以指定为 @auto,以表示使用连接到主机的 IP 地址作为值。如果开发 PC 已连接到多个网络,则这很有用。

### XbUpdateHosts remove

从主机中删除提供的主机名映射。

#### 用法

**xbupdatehosts remove \<*target host name*>**

主机名可以指定为 @auto,以同时删除开发 PC 的主机名和完全限定域名。

### XbUpdateHosts list

列出存储在主机上的所有主机名映射。

#### 用法

**xbupdatehosts list**

此命令输出主机上主机名映射的列表。

### XbUpdateHosts backup

创建存储在主机上的所有主机名映射的备份。

#### 用法

**xbupdatehosts backup \<*backup file name*>**

### XbUpdateHosts restore

从文件中将所有主机名映射还原到主机上。

#### 用法

**xbupdatehosts restore \<*backup file name*>**

## 命令行示例

**XbUpdateHosts** 的常见命令行示例如下。

* 根据连接到主机的地址添加当前开发 PC 的映射:**xbupdatehosts add @auto @auto**

* 根据连接到主机的地址添加另一台主机的映射:**xbupdatehosts add other.host.name @auto**

* 删除映射:**xbupdatehosts remove other.host.name**

* 备份映射:**xbupdatehosts backup .\hostsbackup.txt**

* 还原映射:**xbupdatehosts restore .\hostsbackup.txt**

## XbUpdateHosts 与“从 PC 运行”一起使用

**XbUpdateHosts** 允许修改 Hosts 文件以提供用于解析的静态 IP。这有助于解决在“从 PC 运行”部署中遇到的域名解析问题。

通过 XBTP 的“从 PC 运行”(非服务器消息块 (SMB) 共享语法)会将完全限定域名发送到主机。可通过运行 **ipconfig /all** 找到此名称,并将 “Primary DNS Suffix” 追加到您的开发 PC 名称末尾。完全限定域名格式的示例如下。

mypc.domain.example.com

## 另请参阅

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

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

[将标题部署到 XBOX 开发工具包](/zh-CN/home/setup-install/concepts/deployment.md)


## Related topics

- [XBOX Manager：更新主机](/zh-CN/tools/tools-console/xbom/manager-tool-updating-console.md)
- [面向主机开发的命令行工具](/zh-CN/tools/tools-console/commandlinetools/commandlinetools.md)
- [命令行工具](/zh-CN/tools/tools-console/commandlinetools/index.md)
- [多人游戏测试的 XBOX Manager 最佳实践](/zh-CN/tools/tools-console/xbom/manager-tool-multiplayer.md)
- [Xbox 主机上的本地存储](/zh-CN/build/console-features/storage/local-storage.md)