> ## 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 檔案，而不會作為名稱解析問題的自動解決方案公開。

名稱解析問題最常在使用 Run from PC 部署時遇到。如需搭配 Run from PC 部署使用 **XbUpdateHosts** 的詳細資訊，請參閱本主題稍後的[搭配 Run from PC 使用 XbUpdateHosts](#XbUpdateHosts_RfPC)。

## 命令列格式

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

<a id="XbUpdateHosts_Usage" />

## 命令列使用方式

| 命令 | 描述 |
| - | - |
| [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 | 指定地區設定代碼。用於覆寫預設的地區設定代碼 |

<a id="XbUpdateHosts_Add" />

### XbUpdateHosts add

在主機中新增或取代所提供的主機名稱對應。

#### 使用方式

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

可以為主機名稱指定 @auto，以使用開發 PC 的主機名稱與完整網域名稱。

可以為 IP 位址參數指定 @auto，表示使用連線至主機的 IP 位址作為值。如果開發 PC 連線至多個網路，這會很實用。

<a id="XbUpdateHosts_Remove" />

### XbUpdateHosts remove

從主機移除所提供的主機名稱對應。

#### 使用方式

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

可以為主機名稱指定 @auto，以同時移除開發 PC 的主機名稱與完整網域名稱。

<a id="XbUpdateHosts_List" />

### XbUpdateHosts list

列出儲存在主機上的所有主機名稱對應。

#### 使用方式

**xbupdatehosts list**

此命令會輸出主機上的主機名稱對應清單。

<a id="XbUpdateHosts_Backup" />

### XbUpdateHosts backup

建立儲存在主機上之所有主機名稱對應的備份。

#### 使用方式

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

<a id="XbUpdateHosts_Restore" />

### XbUpdateHosts restore

從檔案將所有主機名稱對應還原至主機。

#### 使用方式

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

<a id="XbUpdateHosts_Examples" />

## 命令列範例

**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**

<a id="XbUpdateHosts_RfPC" />

## 搭配 Run from PC 使用 XbUpdateHosts

**XbUpdateHosts** 可讓您修改 Hosts 檔案，以提供用於解析的靜態 IP。這有助於解決 Run from PC 部署期間遇到的網域名稱解析問題。

透過 XBTP 的 Run from PC (非伺服器訊息區 (SMB) 共用語法) 會將完整網域名稱傳送至主機。使用 **ipconfig /all** 並在開發 PC 名稱的結尾加上「主要 DNS 尾碼」即可找到此名稱。完整網域名稱的格式範例如下。

mypc.domain.example.com

<a id="XbUpdateHosts_SeeAlso" />

## 另請參閱

[命令列工具](/zh-TW/tools/tools-console/commandlinetools/commandlinetools)

[XTF 傳輸錯誤](/zh-TW/tools/tools-console/commandlinetools/xtf-transport-errors)

[將遊戲部署到 XBOX 開發套件](/zh-TW/home/setup-install/concepts/deployment)


## Related topics

- [主機開發的命令列工具](/zh-TW/tools/tools-console/commandlinetools/commandlinetools.md)
- [命令列工具](/zh-TW/tools/tools-console/commandlinetools/index.md)
- [XBOX Manager：更新主機](/zh-TW/tools/tools-console/xbom/manager-tool-updating-console.md)
- [OS 更新頁面](/zh-TW/tools/tools-console/wdp/windows-device-portal-on-xbox-os-update.md)
- [遠端復原 (xbremoterecovery.exe)](/zh-TW/tools/tools-console/commandlinetools/xbremoterecovery.md)