Push-Button Reset Overview
Updated: May 31, 2012
Applies To: Windows 8
On Windows 8 editions, Windows RE includes push-button reset features that enable your users to repair their PCs quickly while preserving their data and important customizations. This can help you satisfy support obligations with faster average resolution times and fewer resources.
You can customize the push-button reset features by inserting custom scripts that can install applications or preserve additional data. This can help you eliminate or lower the development costs of custom recovery solutions.
The following recovery functions are available in push-button reset:
-
Refresh your PC fixes software problems by reinstalling the factory image, while preserving user accounts, data, and Windows® Store apps.
-
Reset your PC prepares the PC for recycling or transfers of ownership by removing all user data and reinstalling the factory image.
Push-button reset features can be run from a hard drive partition with Windows RE, or from external media such as a USB flash drive or DVD that includes Windows RE.
You can also prepare the PC to enable your users to create their own external recovery media, and provide the option to optionally reclaim the hard drive space for their own use. For more information, see How to Configure Bare-Metal Restore/Recovery Media.
The Refresh your PC preserves user data, important settings, and previously installed Windows Store apps.
Note |
|---|
| The Refresh your PC functionality requires that the Windows partition has enough free drive space to install the expanded recovery image, plus an additional 20 percent buffer. We recommend keeping the image size as small as possible. |
This functionality performs the following processes:
-
The PC boots into Windows RE.
-
Push-button reset gathers user accounts, settings, data, and Windows Store apps.
-
Extensibility point: You can add a custom script here by adding its location to ResetConfig.xml in <BasicReset_BeforeImageApply>. For more information, see How to Add a Script to Push-Button Reset Features.
-
Push-button reset expands the factory image file in the recovery partition to a new, temporary operating system folder.
-
Push-button reset applies system-critical settings to the new operating system.
-
Push-button reset moves the old operating system to the Windows.old folder.
-
Push-button reset moves the new operating system from the temporary folder to the root of the current installation.
-
Extensibility point: You can add a custom script here by adding its location to ResetConfig.xml in <BasicReset_AfterImageApply>. For more information, see How to Add a Script to Push-Button Reset Features.
-
Push-button reset reboots the PC into the new operating system.
-
At first boot, push-button reset configures the factory image and reapplies preserved user data and settings.
-
The end user logs into their account.
-
Push-button reset reinstalls Windows Store apps from the Windows Store.
-
Push-button reset adds a list of desktop applications that were not able to be restored to the PC, and stores the list in a file on the Windows desktop.
The following table shows which data folders are preserved, and which are refreshed to their factory-original state.
| Preserved | Refreshed |
|---|---|
|
These folders are copied from the old Windows installation to the new Windows installation:
|
These folders are refreshed to the original state from the recovery image. User data in these folders is not kept.
|
Note |
|---|
| After the Refresh your PC process is complete, users can retrieve their files that are not preserved for a limited amount of time from the C:\Windows.old folder. For example, the C:\ProgramData folder is moved to the C:\Windows.old\ProgramData folder. Although the Windows Task Scheduler deletes most of the C:\Windows.old directory during automatic maintenance, the C:\Windows.old\Users\ folder is kept until your user manually deletes the folder. |
The following table shows which applications are preserved, which are refreshed to their factory-original state, and which must be reinstalled by the user.
| Preserved | Refreshed | Not kept |
|---|---|---|
|
Windows Store apps . These apps are copied from the old installation to the new Windows installation. This includes preinstalled apps and apps purchased from the Windows Store. Internet connectivity isn't required to preserve these apps. |
Preloaded desktop applications. The applications in the recovery image are returned to factory condition, even if your users previously uninstalled these applications. You can configure scripts in push-button reset to save, and later restore, specific application settings and data. For more information, see How to Add a Script to Push-Button Reset Features. |
Desktop applications installed by your users. After the Refresh your PC process is complete, users can see a list of applications that on the PC that were not kept. This list is stored on a file on the Desktop. |
The Refresh your PC functionality preserves many system and user settings required to keep the system running and to minimize the need for your user to reconfigure the PC. The following table details the preserved settings.
| Setting | Description |
|---|---|
|
User accounts and credentials |
Per-user operating system and application settings. |
|
Domain-join settings |
The domain membership of a PC. You don't have to rejoin a domain. |
|
Local group memberships for local and domain user accounts |
The level of access by local and domain users. |
|
Windows Update settings and Automatic Update opt-in settings |
Settings for how recommended updates appear and which users can install updates. If the Automatic Updates feature is enabled, its settings remain unchanged. |
|
Data Protection API (DPAPI) store |
Cached user secrets, such as saved passwords in browsers. |
|
Library settings |
Library settings, stored as .library-ms files in \Roaming\Microsoft\Windows\Libraries under the per-user AppData folders. These library settings enable your users to have a consistent view of their custom library data. |
|
Encrypting File System (EFS) certificates and keys |
EFS-encrypted files. |
|
Drive letter assignments and mount points |
A consistent view of disk partitions and mount points. |
|
Classic desktop personalization |
Desktop themes and other related personalization settings. |
|
Telemetry client IDs and opt-in settings |
Telemetry systems such as Windows Error Reporting (WER), Software Quality Metrics (SQM), and Reliability Analysis Component (RAC). Telemetry systems retain a continuous view of systems, even if the operating system has been reset. |
|
Microsoft® Software License Terms acceptance status, product ID, and activation state |
License terms, product key, and activation information. For more information, see Activation state later in this topic. |
|
Connected accounts |
Accounts that are connected to Microsoft Online Services such as Windows Live®. API is required to preserve connected accounts. |
|
Windows® BitLocker® Drive Encryption and BitLocker To Go® automatic-unlock settings |
BitLocker-enabled data volumes. These are available immediately after basic reset. Your user doesn't have to manually unlock the volumes again. |
|
International settings |
Per-user UI language, locale, and keyboard/input method settings. |
|
Home Group settings |
The ability to join a PC to a Home Group. |
|
Settings for Shell |
Some personalization settings remain unchanged. |
|
Default programs and file type associations |
Changes to default programs and file type associations. |
|
Wireless network profiles |
Wireless network passwords remain unchanged. |
|
Event logs (Application, Security, System) |
Event logs. |
|
Settings configured in out-of-box experience (OOBE) |
All settings that your user configured during OOBE. |
The Reset your PC functionality reinstalls the factory image; removes all user data, settings, and applications; and returns the PC to the default factory state. This function performs the following processes:
-
The PC boots into Windows RE.
-
If there is more than one user-accessible partition, then your user chooses whether to format the entire hard drive or just the Windows partition. For more information, see How to Configure Bare-Metal Restore/Recovery Media.
-
Your user chooses whether to simply format their hard drive partition (Quick option), or to clean the hard drive by attempting to overwrite all existing user data (Thorough option).
Note Neither option is certified to meet government or industry data erasure standards. -
Extensibility point: You can add a custom script here by adding its location to ResetConfig.xml in <FactoryReset_AfterDiskFormat>. For more information, see How to Add a Script to Push-Button Reset Features.
-
Push-button reset formats the data partitions (optional).
-
Push-button reset applies the factory image from the recovery partition to the Windows partition.
-
Push-button reset recreates the boot configuration data (BCD) store on the system partition.
-
Extensibility point: You can add a custom script here by adding its location to ResetConfig.xml in <FactoryReset_AfterImageApply>. For more information, see How to Add a Script to Push-Button Reset Features.
-
Push-button reset reboots the PC into the new operating system.
-
Windows starts the Out of Box Experience (OOBE).
If the user needs to replace their hard drive, or completely wipe it, they can use bootable recovery media, This function performs the following processes:
-
The PC boots into Windows RE.
-
Push-button reset identifies the system drive.
-
Push-button reset recreates and formats each of the partitions specified in the diskpart script.
-
Push-button reset applies the factory image file to the Windows partition.
-
Push-button configures Windows RE and the recovery image on the disk.
-
Windows restarts into the OOBE.
For more information, see How to Configure Bare-Metal Restore/Recovery Media.
To configure push-button reset features, you must deploy Windows by creating partitions and capturing and applying images. Windows Setup does not configure a push-button reset recovery image, nor does it prepare a recovery image partition.
We recommend adding the push-button reset recovery image into a dedicated partition at the end of the hard drive. By following this recommendation, your users can delete the partition to reclaim several gigabytes of drive space if needed without affecting the Windows RE tools, which can still function to repair common boot problems.
To prevent your users from accessing and formatting your recovery image partitions, set the following attributes:
-
Unified Extensible Firmware Interface (UEFI)
: Set the partition type as PARTITION_MSFT_RECOVERY_GUID. In addition, set the partition attributes as GPT_ATTRIBUTE_PLATFORM_REQUIRED and GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER. For more information, see PARTITION_INFORMATION_GPT structure.
-
BIOS: Set the type to any value other than 0x7, 0x0c, 0x0b, 0x0e, 0x06, or 0x42.
For more information, see How to Deploy Push-Button Reset Features.
For more information about configuring hard drive partitions, see How to Configure UEFI/GPT-Based Hard Drive Partitions or How to Configure BIOS/MBR-Based Hard Drive Partitions.
The recovery image must be stored in a folder named Recovery, for example, R:\Recovery\install.wim.
The recovery image may be either a single Windows image file named install.wim, or a set of split Windows image files that meet the following criteria:
-
The leading file must be named
install.swm. -
Subsequent files must appear in the Install<image_index>.swm format, where <image_index> is the selected image in the collection. For example,
Install2.swm,Install3.swm. -
Each .SWM file must be smaller than 4GB.
-
All .SWM files must be located in the same folder as your recovery image, for example,
R:\RecoveryImage\(install.swm, install2.swm, and install3.swm). For more information about splitting a Windows image file, see How to Split a Windows Image (.swm) File to Span Across Multiple DVDs or CDs.
For more information about deploying Push-button reset, see How to Deploy Push-Button Reset Features.
Push-button reset features attempt to preserve the activation status and store, and migrate these settings in both a refresh and reset. If the migration succeeds, the system will remain in an activated state after the refresh operation.
Note |
|---|
The activation status may not be able to be migrated for a few reasons:
|
See Also
