Remote Recovery (xbremoterecovery.exe)
Remote recovery provides the following subcommands and functions.
| Command | Description |
|---|---|
| xbremoterecovery install | Installs a LIVE system update by downloading data from the PC. Note: XBOX Live must authorize the console to install the update. |
| xbremoterecovery getversion | Gets the version of the system software currently running on the console. |
| xbremoterecovery resetresume | Forces "clear system update/update resume data" on the next update attempt. |
xbremoterecovery install
Installs a LIVE system update by downloading data from the PC.
Note: XBOX Live must authorize the console to install the update.
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 | Path to a directory that contains the system update data files (system.xvd, host.xvd, updater.xvd, update.ini, etc.) | ||||||
| /factoryreset[:VALUE] | Performs a factory reset on the console. The following values are accepted:
| ||||||
| /log | Generates content suitable for a log file. | ||||||
| /noidletimeout | Disables the idle shutdown timer. This is useful for testing scenarios where the customer would never want the console to turn off due to inactivity. | ||||||
| /xblsandbox:VALUE | This switch overrides the default sandbox. This is especially useful the first time a console is setup because every console starts in the RETAIL sandbox which isn't useful for devkits. This switch must be used the first time a devkit is recovered to make sure it ends up in the right sandbox. | ||||||
| /provision:<path to xbProvision manifest> | This switch causes the console to be provisioned with developer tools after a successful recovery. This switch has the same effect as calling xbprovision and is used in place of calling xbprovision. The argument is the path to the ini file in the XDK/ADK sideload directory. For example: /provision:"C:\Program Files (x86)\Microsoft Durango XDK\sideload\xbProvision.ini"If the path to the provisioning manifest is wrong, xbremoterecovery will display the error code 80070002: Error Code: 80070002 | ||||||
| /savehostname | Preserves the user provided name of the console. Use this option when downgrading from one build to another. | ||||||
| /sethostname:NAME | Renames the console with the provided name. | ||||||
| /X[:]address[+<accesskey>] | Specifies the host name or address (shown as Tools IP on the console) of a targeted console, but does not change the default console. For information about setting a host name for a console, see Setting a Hostname for the Console IP Address.If you do not use this option, the default console (previously set by Connect (xbconnect.exe)) is used.Accesskey is a string that you can use to restrict access to a console to only those people who know the access key. Set the access key by using the command xbconfig accesskey=your-key; then, restart your console to make the access key effective. To access a console that is configured with an access key, you must include a plus sign (+) and the access key after the IP address or host name of the console. For more information about access keys, see xbconfig accesskey.
|
Note Return to the top of this topic.
xbremoterecovery getversion
Retrieves the version number associated with the system software currently running on the console.
xbremoterecovery getversion
|
Return to the top of this topic.
xbremoterecovery resetresume
Forces “clear system update/update resume data” on the next update attempt.
xbremoterecovery resetresume
|
Return to the top of this topic.