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 à partir d’une invite de commandes du 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

Sur Windows 7, exécutez cette commande une seule fois à partir d’une invite de commandes administrateur pour que la résolution des noms d’hôte fonctionne de façon fiable :
Non nécessaire sur Windows 8 ou une version ultérieure. Les noms d’hôte peuvent ensuite ê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 ou d’une réinitialisation d’usine

La réinitialisation d’usine efface le nom d’hôte, ce qui brise les étapes ultérieures d’une récupération. Prévenez cela en :
  • Sautant la réinitialisation d’usine dans le cadre 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 vos scripts personnalisés). Elle préserve des paramètres comme Hostname et Sandbox ID.
  • Exécutant xbcleanup /F manuellement à partir de l’interface Paramètres lorsqu’une réinitialisation d’usine est requise. Si vous récupérez vers une build plus ancienne, le processus force une réinitialisation.
Lorsqu’une réinitialisation est requise, 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 la récupération ou la 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 à l’aide de 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 exige habituellement 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 des noms 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 sur le même sous-réseau que la console, mais peuvent ne pas fonctionner dans des configurations de laboratoire s’étendant sur plusieurs sous-réseaux.
Dernière modification le 1 septembre 2026