Pular para o conteúdo principal
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.
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.

​
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:
A unicidade dos nomes não é imposta — evite duplicatas, por exemplo, derivando o nome de host do nome do PC de desenvolvimento.

​
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:
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:

​
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:
  2. Execute a recuperação ou a redefinição de fábrica usando o IP obtido.
  3. Restaure o nome de host:

​
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”):

​
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.
Última modificação em 1 de setembro de 2026