> ## 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 kit de développement XBOX un nom d'hôte convivial 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`** depuis une invite de commandes 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

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 :

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

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 :

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

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


## Related topics

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