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

# Définir un nom d'hôte convivial pour un kit de développement XBOX

> Attribuez un nom d'hôte convivial à un kit de développement XBOX dans XBOX Manager ou DevHome afin que les outils continuent de fonctionner lorsque l'adresse IP de la console change sur le réseau.

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.

<Note>
  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.
</Note>

## 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 :
  ```text theme={null}
  xbconfig HostName=name
  ```

<Warning>
  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.
</Warning>

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

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

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 :

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

### 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 :
   ```text theme={null}
   xbconnect.exe /q /b /t <hostname>
   ```
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 :
   ```text theme={null}
   xbconfig HostName=<HostName>
   xbreboot
   ```

#### 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 ») :

```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%
```

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


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [Index des rubriques NDA pour le développement sur console avec XBOX GDK](/fr-CA/nda/nda-overview.md)
- [Developer Home sur la console (Dev Home)](/fr-CA/tools/tools-console/devhome/devhome.md)
- [Récupération à distance (xbremoterecovery.exe)](/fr-CA/tools/tools-console/commandlinetools/xbremoterecovery.md)
- [Redémarrage (xbreboot.exe)](/fr-CA/tools/tools-console/commandlinetools/xbreboot.md)