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

# Definir um nome de host amigável para um dev kit XBOX

> Dê um nome de host amigável a um dev kit XBOX no XBOX Manager ou no DevHome para que as ferramentas continuem funcionando quando o endereço IP do console mudar na rede.

Defina um **nome de host** amigável para um dev kit para que as ferramentas possam se referir a ele pelo nome em vez do IP. Os nomes de host sobrevivem a mudanças de endereço IP no console.

<Note>
  As ferramentas e o IP do console são amplamente intercambiáveis, mas os nomes de host são preferíveis se o IP do dev kit for renovado periodicamente.
</Note>

## Especificar um nome de host

Use qualquer um dos seguintes:

* **XBOX Manager**: **Add Console** → selecione o console → guia **Settings** → altere o nome de host → **Save Settings** → **Yes** para reiniciar.
* **No dev kit**: **Settings** → **System** → defina **Name**.
* **XBOX Device Portal**: **Settings** → **Device name**.
* **`xbconfig`** em um prompt de comando do GDK:
  ```text theme={null}
  xbconfig HostName=name
  ```

<Warning>
  A unicidade dos nomes não é imposta — evite duplicatas, por exemplo, derivando o nome de host do nome do PC de desenvolvimento.
</Warning>

## Conectar usando o nome de host

No **Windows 7**, execute isto uma vez em um prompt de comando de administrador para que a resolução de nomes de host funcione de forma confiável:

```text theme={null}
reg add HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\DNSCache\Parameters /v MaxNegativeCacheTTL /d 0 /t REG_DWORD
```

Não é necessário no Windows 8 ou posterior.

Os nomes de host podem então ser usados em qualquer lugar onde um IP de console funcione. Exemplos:

```text theme={null}
xbconnect name
xbtool /x:name
```

### Preservar o nome de host durante a recuperação / redefinição de fábrica

A redefinição de fábrica apaga o nome de host, o que quebra as etapas posteriores de uma recuperação. Evite isso:

* Pulando a redefinição de fábrica como parte da recuperação.
* Usando a opção `/factoryreset:savesettings` (este é o padrão ao recuperar; adicione-a explicitamente em scripts personalizados). Ela preserva configurações como `Hostname` e `Sandbox ID`.
* Executando `xbcleanup /F` manualmente pela interface de Settings quando a redefinição de fábrica for necessária. Se você recuperar para uma build mais antiga, o processo força uma redefinição.

Quando uma redefinição for necessária, sempre passe o IP do console com `/x:`.

### Obter o IP e restaurar o nome de host

1. Antes da recuperação ou redefinição, obtenha o IP pelo nome de host:
   ```text theme={null}
   xbconnect.exe /q /b /t <hostname>
   ```
2. Execute a recuperação ou a redefinição de fábrica usando o IP obtido.
3. Restaure o nome de host:
   ```text theme={null}
   xbconfig HostName=<HostName>
   xbreboot
   ```

#### Exemplo de script completo

Carregue o IP atual em uma variável de ambiente, recupere e restaure o nome de host (nome de host "Xb1"):

```cmd theme={null}
xbconnect /Q /B /T Xb1>%TEMP%\console_Xb1_last_tools_address.txt
set CONSOLE_Xb1_LAST_TOOLS_ADDRESS=
FOR /F %%i IN (%TEMP%\console_Xb1_last_tools_address.txt) DO SET CONSOLE_Xb1_LAST_TOOLS_ADDRESS=%%i
del %TEMP%\console_Xb1_last_tools_address.txt
REM Recover 'Xb1' by using its last known raw tools address.
XboxOneUpdate.bat /x:%CONSOLE_Xb1_LAST_TOOLS_ADDRESS%
REM Restore the hostname for 'Xb1', and restart for it to take effect.
xbconfig /x:%CONSOLE_Xb1_LAST_TOOLS_ADDRESS% HostName=Xb1
xbreboot /x:%CONSOLE_Xb1_LAST_TOOLS_ADDRESS%
```

## Considerações de rede

A conectividade por nome de host normalmente exige que o PC de desenvolvimento e o console estejam na **mesma sub-rede IP**. Se seus servidores DNS não aceitarem atualizações de dispositivos não autenticados, a resolução de nomes de host recorre ao **LLMNR**, que só funciona na mesma sub-rede.

Na prática: os nomes de host funcionam bem para desenvolvedores individuais, artistas e produtores na mesma sub-rede que o console, mas podem não funcionar em configurações de laboratório entre sub-redes.


## Related topics

- [Índice de tópicos sob NDA para desenvolvimento de console com o XBOX GDK](/pt-BR/nda/nda-overview.md)
- [Atualizar hosts (XbUpdateHosts.exe)](/pt-BR/tools/tools-console/commandlinetools/xbupdatehosts.md)
- [Developer Home no console (Dev Home)](/pt-BR/tools/tools-console/devhome/devhome.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Recuperação remota (xbremoterecovery.exe)](/pt-BR/tools/tools-console/commandlinetools/xbremoterecovery.md)