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

# Récupération à distance (xbremoterecovery.exe)

> Récupération à distance (xbremoterecovery.exe)

Utilisez cet outil pour lancer une mise à jour du système sur les consoles de la famille XBOX One et les consoles XBOX Series. Cet outil permet d'obtenir des mises à jour du système à partir d'une destination PC locale, des services XBOX ou d'un CDN personnalisé. Il fournit les sous-commandes et fonctions suivantes.

| Commande | Description |
| - | - |
| [xbremoterecovery install](#xbremoterecovery_install) | Installe une mise à jour du système Live en téléchargeant les données depuis le PC. Les services XBOX doivent autoriser la console à installer la mise à jour. |
| [xbremoterecovery live](#xbremoterecovery_live) | Installe une mise à jour du système Live en téléchargeant les données depuis le nuage. Nécessite que les services XBOX autorisent la console à installer la mise à jour. |
| [xbremoterecovery getversion](#xbremoterecovery_getversion) | Récupère le numéro de version associé au logiciel système en cours d'exécution sur la console. |
| [xbremoterecovery getversionid](#xbremoterecovery_getversionid) | Récupère l'ID de version associé au logiciel système en cours d'exécution sur la console. |
| [xbremoterecovery resetresume](#xbremoterecovery_resetresume) | Efface les mises à jour en cours afin que la prochaine tentative démarre une nouvelle mise à jour. |

<a id="ID4EUC" />

<a id="xbremoterecovery_install" />

## xbremoterecovery install

Installe une mise à jour du système Live en téléchargeant les données depuis le PC. Les services XBOX doivent autoriser la console à installer la mise à jour.

| Colonne 1 |
| - |
| \*\*xbremoterecovery install \*\**update\_path* \[/factoryreset\[:VALUE] ] \[/log] \[/noidletimeout] \[/xblsandbox:VALUE] \[/provision:\<path to xbProvision manifest>] \[/savehostname] \[/sethostname:NAME] \[/X\[:]*address\[+\<accesskey>]*] |

| Option | Description |
| - | - |
| *update\_path* | Chemin d'un répertoire contenant les fichiers de données de la mise à jour du système. <br />Par exemple, system.xvd, host.xvd, updater.xvd et update.ini. |
| /factoryreset\[:VALUE] | Force la réinitialisation de tous les paramètres et de le stockage interne.<br />**Aucune valeur** : réinitialise complètement tous les paramètres et le contenu à leur état par défaut.<br />**savesettings** : conserve les paramètres lors de la réinitialisation aux paramètres d'usine. |
| /log | Génère un contenu adapté à un fichier journal. |
| /noidletimeout | Désactive le minuteur d'arrêt pour inactivité. Utile pour tester un scénario dans lequel l'utilisateur ne voudrait jamais que la console s'éteigne pour cause d'inactivité. |
| /xblsandbox:VALUE | Remplace le bac à sable par défaut. Particulièrement utile lors de la première configuration d'une console, car chaque console démarre dans le bac à sable RETAIL, ce qui n'est pas pratique pour les kits de développement. Ce commutateur doit être utilisé lors de la première récupération d'un kit de développement pour garantir qu'il rejoint le bon bac à sable. |
| /savehostname | Utilisez cette option lors de la rétrogradation d'une build lorsque vous voulez conserver le nom d'hôte de la console. Utilisée avec /factoryreset, cette option conserve le nom d'hôte. |
| /sethostname:NAME | Semblable à /savehostname, mais remplace le nom d'hôte par le NAME fourni. |
| /X\[:]*address\[+\<accesskey>]* | - Utilisez cette option pour spécifier le nom d'hôte ou l'adresse (affichée en tant que **Tools IP** sur la console) d'une console cible sans modifier la console par défaut. Pour plus de renseignements sur la définition d'un nom d'hôte pour une console, consultez [Définir un nom d'hôte pour l'adresse IP de la console](/fr-CA/home/setup-install/dev-kit-settings/setting-a-hostname).<br />- Si vous n'utilisez pas cette option, la console par défaut (définie précédemment à l'aide de [Connexion (xbconnect.exe)](/fr-CA/tools/tools-console/commandlinetools/xbconnect)) est utilisée. <br />- Utilisez la chaîne *accesskey* pour limiter l'accès à la console aux seules personnes qui disposent de la clé d'accès. <br />- Définissez la clé d'accès à l'aide de la commande **xbconfig** **accesskey=your-key**, puis redémarrez votre console pour que la clé d'accès prenne effet.<br />- Pour accéder à une console configurée avec une clé d'accès, ajoutez un signe plus (+) suivi de la clé d'accès après l'adresse IP ou le nom d'hôte de la console.<br />- Si une clé d'accès est fournie lors de la définition de la console par défaut avec [xbconnect](/fr-CA/tools/tools-console/commandlinetools/xbconnect), la clé d'accès est stockée dans l'adresse de la console par défaut.<br />- Pour plus de renseignements sur les clés d'accès, consultez [xbconfig accesskey](/fr-CA/tools/tools-console/commandlinetools/xbconfig). |

[Retour en haut de cette rubrique.](/fr-CA/tools/tools-console/commandlinetools/xbremoterecovery)

<a id="xbremoterecovery_live" />

## xbremoterecovery live

Installe une mise à jour du système Live en téléchargeant les données depuis le nuage. Nécessite que les services XBOX autorisent la console à installer la mise à jour.

| Colonne 1 |
| - |
| **xbremoterecovery live \[VERSIONID] \[/cdnoverride:VALUE]** |

| Option | Description |
| - | - |
| VERSIONID | ID de version exact à installer, au format x.x.xxxx.x.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Si une console de développement est configurée pour les mises à jour manuelles, VERSIONID est un paramètre obligatoire. Sinon, l'omission de ce paramètre entraîne la mise à jour vers la version la plus récente disponible pour son groupe de mises à jour système (System Update Group). La valeur VERSIONID peut être déterminée de l'une des manières suivantes : 1. Examinez le fichier update.ini d'un fichier .zip de récupération téléchargé depuis [https://aka.ms/gdkdl](https://aka.ms/gdkdl). Par exemple, voici l'ID de version de la mise à jour de récupération QFE 1 de mars 2021 : `VersionId=10.0.19041.6737.31cedb80-46ab-407b-b277-1c67bd056f4c` 2. Exécutez `xbremoterecovery.exe` avec le commutateur de ligne de commande `getversionid`. |
| /cdnoverride:VALUE | Remplace la valeur de CDN retournée par les services XBOX par un point de terminaison CDN personnalisé. Il est conseillé de fournir le paramètre VERSIONID lors de l'utilisation de cette option. Le chemin complet de tous les fichiers de mise à jour doit être le suivant : `\|----- CDN override value ----\|-------------- Version ID of the build -------------\| Flat directory of update files \|` `http://example.com/xboxupdates/10.0.19041.6288.afaf9289-dc86-45ab-9515-02554081a1e8/*` |

[Retour en haut de cette rubrique.](/fr-CA/tools/tools-console/commandlinetools/xbremoterecovery)

<a id="xbremoterecovery_getversion" />

## xbremoterecovery getversion

Récupère le numéro de version associé au logiciel système en cours d'exécution sur la console.

| Colonne 1 |
| - |
| \*\*xbremoterecovery getversion \*\* |

[Retour en haut de cette rubrique.](/fr-CA/tools/tools-console/commandlinetools/xbremoterecovery)

<a id="xbremoterecovery_getversionid" />

## xbremoterecovery getversionid

Récupère l'ID de version associé au logiciel système en cours d'exécution sur la console. Cet ID peut être utilisé comme valeur VERSIONID lors de l'exécution de la commande <a href="#xbremoterecovery_live">xbremoterecovery live</a>.

| Colonne 1 |
| - |
| \*\*xbremoterecovery getversionid \*\* |

[Retour en haut de cette rubrique.](/fr-CA/tools/tools-console/commandlinetools/xbremoterecovery)

<a id="xbremoterecovery_resetresume" />

## xbremoterecovery resetresume

Efface les mises à jour en cours afin que la prochaine tentative démarre une nouvelle mise à jour.

| Colonne 1 |
| - |
| \*\*xbremoterecovery resetresume \*\* |

Dans certains cas, la récupération échoue mais laisse cet indicateur défini pour signaler qu'une mise à jour est en cours. Ce commutateur efface cet indicateur afin que les mises à jour suivantes puissent se poursuivre. Vous pouvez aussi redémarrer la console pour effacer cet indicateur.

[Retour en haut de cette rubrique.](/fr-CA/tools/tools-console/commandlinetools/xbremoterecovery)

<a id="ID4ENBAC" />

## Voir aussi

[Outils en ligne de commande](/fr-CA/tools/tools-console/commandlinetools/commandlinetools)

[Erreurs de transport XTF](/fr-CA/tools/tools-console/commandlinetools/xtf-transport-errors)

[Connexion (xbconnect.exe)](/fr-CA/tools/tools-console/commandlinetools/xbconnect)


## Related topics

- [Outils en ligne de commande pour le développement sur console](/fr-CA/tools/tools-console/commandlinetools/commandlinetools.md)
- [Outils en ligne de commande](/fr-CA/tools/tools-console/commandlinetools/index.md)
- [URI de récupération à distance](/fr-CA/reference/deviceportal/remote/atoc-rest-remote.md)
- [Récupération (wdRecovery.exe)](/fr-CA/tools/tools-console/console_commandlinetools/wdrecovery.md)
- [Référence de l'API REST de Windows Device Portal](/fr-CA/reference/deviceportal/atoc-deviceportal-reference.md)
