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

# Atualizar hosts (XbUpdateHosts.exe)

> Atualizar hosts (XbUpdateHosts.exe)

Use esta ferramenta para mapear um nome de host/domínio especificado para um endereço IP especificado no XBOX Development Kit. Problemas com a resolução de nomes têm sido mais frequentes ao desenvolver em um ambiente de trabalho em casa. O **XbUpdateHosts** fornece um endereço IP específico para um nome de host/domínio específico, substituindo a forma como o XBOX Development Kit normalmente resolveria esse nome. Essa ferramenta requer a entrada do usuário, que configura o arquivo HOSTS no XBOX Development Kit, e não é exposta como uma solução automática para problemas de resolução de nomes.

Os problemas encontrados com a resolução de nomes têm sido mais comuns ao usar a implantação Run from PC. Para obter mais informações sobre o uso do **XbUpdateHosts** com a implantação Run from PC, veja [Uso do XbUpdateHosts com Run from PC](#XbUpdateHosts_RfPC) mais adiante neste tópico.

## Formato da linha de comando

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

<a id="XbUpdateHosts_Usage" />

## Uso da linha de comando

| Comando | Descrição |
| - | - |
| [xbupdatehosts add](#XbUpdateHosts_Add) | Adiciona ou substitui o mapeamento de nome de host fornecido no console |
| [xbupdatehosts remove](#XbUpdateHosts_Remove) | Remove o mapeamento de nome de host fornecido do console |
| [xbupdatehosts list](#XbUpdateHosts_List) | Lista todos os mapeamentos de nomes de host armazenados no console |
| [xbupdatehosts backup](#XbUpdateHosts_Backup) | Cria um backup de todos os mapeamentos de nomes de host armazenados no console |
| [xbupdatehosts restore](#XbUpdateHosts_Restore) | Restaura todos os mapeamentos de nomes de host para o console a partir de um arquivo |
| [xbupdatehosts examples /?](#XbUpdateHosts_Examples) | Lista exemplos de uso dos comandos comuns do **XbUpdateHosts** |
| [xbupdatehosts commands /?](#XbUpdateHosts_Usage) | Lista todos os comandos disponíveis do **XbUpdateHosts** |
| [xbupdatehosts `<command>` /?](#XbUpdateHosts_Usage) | Lista as informações de Ajuda de um comando específico do **XbUpdateHosts** |
| /LC | Especifica o código de localidade. Usado para substituir o código de localidade padrão |

<a id="XbUpdateHosts_Add" />

### XbUpdateHosts add

Adiciona ou substitui o mapeamento de nome de host fornecido no console.

#### Uso

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

@auto pode ser especificado para o nome do host para usar o nome do host e o nome de domínio totalmente qualificado do PC de desenvolvimento.

@auto pode ser especificado para o parâmetro de endereço IP para indicar que o endereço IP que está se conectando ao console seja usado como valor. Isso é útil se o PC de desenvolvimento estiver conectado a várias redes.

<a id="XbUpdateHosts_Remove" />

### XbUpdateHosts remove

Remove o mapeamento de nome de host fornecido do console.

#### Uso

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

@auto pode ser especificado para o nome do host para remover o nome do host e o nome de domínio totalmente qualificado do PC de desenvolvimento.

<a id="XbUpdateHosts_List" />

### XbUpdateHosts list

Lista todos os mapeamentos de nomes de host armazenados no console.

#### Uso

**xbupdatehosts list**

Esse comando gera a lista de mapeamentos de nomes de host que estão no console.

<a id="XbUpdateHosts_Backup" />

### XbUpdateHosts backup

Cria um backup de todos os mapeamentos de nomes de host armazenados no console.

#### Uso

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

<a id="XbUpdateHosts_Restore" />

### XbUpdateHosts restore

Restaura todos os mapeamentos de nomes de host para o console a partir de um arquivo.

#### Uso

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

<a id="XbUpdateHosts_Examples" />

## Exemplos de linha de comando

Os exemplos comuns de linha de comando do **XbUpdateHosts** são os seguintes.

* Adicionar um mapeamento para o PC de desenvolvimento atual com base no endereço que está se conectando ao console: **xbupdatehosts add @auto @auto**

* Adicionar um mapeamento para outro host com base no endereço que está se conectando ao console: **xbupdatehosts add other.host.name @auto**

* Remover um mapeamento: **xbupdatehosts remove other.host.name**

* Fazer backup dos mapeamentos: **xbupdatehosts backup .\hostsbackup.txt**

* Restaurar os mapeamentos: **xbupdatehosts restore .\hostsbackup.txt**

<a id="XbUpdateHosts_RfPC" />

## Uso do XbUpdateHosts com Run from PC

O **XbUpdateHosts** permite modificar o arquivo Hosts para fornecer um IP estático para resolução. Isso pode ajudar a resolver problemas de resolução de nomes de domínio encontrados durante a implantação Run from PC.

O Run from PC por XBTP (sintaxe que não usa compartilhamento Server Message Block (SMB)) envia o nome de domínio totalmente qualificado ao console. Esse nome é encontrado usando **ipconfig /all** e adicionando o "Primary DNS Suffix" ao final do nome do seu PC de desenvolvimento. Veja a seguir um exemplo do formato de um nome de domínio totalmente qualificado.

mypc.domain.example.com

<a id="XbUpdateHosts_SeeAlso" />

## Veja também

[Ferramentas de linha de comando](/pt-BR/tools/tools-console/commandlinetools/commandlinetools)

[Erros de transporte do XTF](/pt-BR/tools/tools-console/commandlinetools/xtf-transport-errors)

[Implantar seu título no XBOX Development Kit](/pt-BR/home/setup-install/concepts/deployment)


## Related topics

- [Ferramentas de linha de comando para desenvolvimento em console](/pt-BR/tools/tools-console/commandlinetools/commandlinetools.md)
- [Ferramentas de linha de comando](/pt-BR/tools/tools-console/commandlinetools/index.md)
- [xbCopy (xbcopy.exe)](/pt-BR/tools/tools-console/commandlinetools/xbcopy.md)
- [Recuperação remota (xbremoterecovery.exe)](/pt-BR/tools/tools-console/commandlinetools/xbremoterecovery.md)
- [xbWatson](/pt-BR/tools/tools-console/xbWatson/xbwatson.md)
