Récupération à distance (xbremoterecovery.exe) - XBOX Game Development Documentation

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	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	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	Récupère le numéro de version associé au logiciel système en cours d’exécution sur la console.
xbremoterecovery getversionid	Récupère l’ID de version associé au logiciel système en cours d’exécution sur la console.
xbremoterecovery resetresume	Efface les mises à jour en cours afin que la prochaine tentative démarre une nouvelle mise à jour.

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. 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. Aucune valeur : réinitialise complètement tous les paramètres et le contenu à leur état par défaut. 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. - Si vous n’utilisez pas cette option, la console par défaut (définie précédemment à l’aide de Connexion (xbconnect.exe)) est utilisée. - Utilisez la chaîne accesskey pour limiter l’accès à la console aux seules personnes qui disposent de la clé d’accès. - 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. - 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. - Si une clé d’accès est fournie lors de la définition de la console par défaut avec xbconnect, la clé d’accès est stockée dans l’adresse de la console par défaut. - Pour plus de renseignements sur les clés d’accès, consultez xbconfig accesskey.

Retour en haut de cette rubrique.

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

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.

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 xbremoterecovery live.

Colonne 1
xbremoterecovery getversionid

Retour en haut de cette rubrique.

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.

Voir aussi

Outils en ligne de commande Erreurs de transport XTF Connexion (xbconnect.exe)

​xbremoterecovery install

​xbremoterecovery live

​xbremoterecovery getversion

​xbremoterecovery getversionid

​xbremoterecovery resetresume

​Voir aussi

xbremoterecovery install

xbremoterecovery live

xbremoterecovery getversion

xbremoterecovery getversionid

xbremoterecovery resetresume

Voir aussi