Passer au contenu principal
Définissez un nom d’hôte convivial pour un kit de développement afin que les outils puissent s’y adresser par nom plutôt que par adresse IP. Les noms d’hôte survivent aux changements d’adresse IP de la console.
Les outils acceptent indifféremment le nom d’hôte et l’adresse IP de la console, mais les noms d’hôte sont préférables si l’adresse IP du kit de développement est renouvelée périodiquement.

Spécifier un nom d’hôte

Utilisez l’une des méthodes suivantes :
  • XBOX Manager : Add Console → sélectionnez la console → onglet Settings → modifiez le nom d’hôte → Save Settings → Yes pour redémarrer.
  • Sur le kit de développement : Paramètres → Système → définissez Nom.
  • XBOX Device Portal : Settings → Device name.
  • xbconfig depuis une invite de commandes GDK :
L’unicité des noms n’est pas imposée — évitez les doublons, par exemple en dérivant le nom d’hôte du nom du PC de développement.

Se connecter à l’aide du nom d’hôte

Sous Windows 7, exécutez cette commande une seule fois depuis une invite de commandes administrateur pour que la résolution du nom d’hôte fonctionne de manière fiable :
Inutile sous Windows 8 ou version ultérieure. Les noms d’hôte peuvent alors être utilisés partout où une adresse IP de console fonctionne. Exemples :

Préserver le nom d’hôte lors d’une récupération / réinitialisation d’usine

La réinitialisation d’usine efface le nom d’hôte, ce qui casse les étapes ultérieures d’une récupération. Évitez cela en :
  • Ignorant la réinitialisation d’usine lors de la récupération.
  • Utilisant l’option /factoryreset:savesettings (c’est la valeur par défaut lors d’une récupération ; ajoutez-la explicitement dans les scripts personnalisés). Elle préserve des paramètres comme Hostname et Sandbox ID.
  • Exécutant xbcleanup /F manuellement via l’interface Paramètres lorsqu’une réinitialisation d’usine est nécessaire. Si vous récupérez vers une build plus ancienne, le processus force une réinitialisation.
Lorsqu’une réinitialisation est nécessaire, passez toujours l’adresse IP de la console avec /x:.

Récupérer l’adresse IP et rétablir le nom d’hôte

  1. Avant une récupération ou une réinitialisation, obtenez l’adresse IP à partir du nom d’hôte :
  2. Exécutez la récupération ou la réinitialisation d’usine via l’adresse IP récupérée.
  3. Rétablissez le nom d’hôte :

Exemple de script complet

Chargez l’adresse IP actuelle dans une variable d’environnement, effectuez la récupération, puis rétablissez le nom d’hôte (nom d’hôte « Xb1 ») :

Considérations réseau

La connectivité par nom d’hôte nécessite généralement que le PC de développement et la console soient sur le même sous-réseau IP. Si vos serveurs DNS n’acceptent pas les mises à jour provenant d’appareils non authentifiés, la résolution du nom d’hôte se rabat sur LLMNR, qui ne fonctionne que sur le même sous-réseau. En pratique : les noms d’hôte fonctionnent bien pour les développeurs individuels, les artistes et les producteurs situés sur le même sous-réseau que la console, mais peuvent ne pas fonctionner dans des configurations de laboratoire inter-sous-réseaux.
Dernière modification le 9 octobre 2026