How Sysprep Works https://technet.microsoft.com/en-us/library/cc766514(v=ws.10).

aspx

How Sysprep Works

The System Preparation tool, Sysprep.exe, is used to prepare an installation of Windows for imaging or delivery to a
customer.

This topic includes:

Sysprep Executable
Sysprep Processes
Using an Answer File with Sysprep
Resetting Windows Activation
Detecting the State of a Windows Image
Sysprep Log Files

Sysprep Executable
Sysprep.exe is the main program that calls other executable files that prepare the Windows installation. Sysprep.exe is
located in the %WINDIR%\system32\sysprep directory on all installations. Sysprep must always be run from the
%WINDIR%\system32\sysprep directory and must run on the version of Windows with which it was installed.

Sysprep Process
When Sysprep runs, it goes through the following process:

1. Verifies that Sysprep can run. Only an administrator can run Sysprep, and only one instance of Sysprep can run at
a given time. Also, Sysprep must run on the version of Windows with which it was installed.
2. Initializes logging.
3. Parses command-line arguments.
If no command-line arguments were provided, the Sysprep window appears that enables users to specify Sysprep
actions.
4. Processes Sysprep actions, calls appropriate .dll files and executable files, and adds actions to the log file.
5. Verifies that all .dll files have processed all their tasks, and then either shuts down the system, restarts the system,
or exits Sysprep.

Using Answer Files with Sysprep

You can use an answer file with Sysprep to configure unattended Setup settings. The following sections describe some of
the considerations and processes for using answer files with Sysprep.

Applying Settings in the generalize, auditSystem and auditUser passes

Not all configuration passes run during Windows Setup. Some configuration passes are only available when you run
Sysprep. The generalize, auditSystem and auditUser passes are available only by running Sysprep. If you add settings to
your answer file in these configuration passes, you must run Sysprep to apply these settings:

To apply the settings in auditSystem and auditUser, you must boot to Audit mode by using the sysprep/audit
command.
To apply the settings in the generalize pass, you must generalize the Windows image by using the
sysprep/generalize command.

For more information, see How Configuration Passes Work. For more information about Sysprep command-line options,
see Sysprep Command-Line Syntax.

Caching Answer Files to the Computer

1 of 5 20/05/2016 17:32
How Sysprep Works https://technet.microsoft.com/en-us/library/cc766514(v=ws.10).aspx

If you install Windows by using an answer file, that answer file is cached to the system so when subsequent configuration
passes run, settings in the answer file are applied to the system.

Because this answer file is cached, when you run Sysprep, settings in the cached answer file are applied. If you use the
settings in a different answer file, you can specify a separate Unattend.xml file by using the sysprep /unattend:filename
option. For more information, see Sysprep Command-Line Syntax.

For more information about using implicit answer file search, see How Windows Setup Works.

Persisting Plug and Play Device Drivers during generalize

You can persist device drivers when you run the sysprep /generalize command by specifying the
PersistentAllDeviceInstalls setting in the Microsoft-Windows-PnPSysprep component. During the specialize pass, Plug
and Play scans the computer for devices and installs device drivers for the detected devices. By default, these device
drivers are removed from the system when you generalize the system. If you set PersistAllDeviceInstalls to True in an
answer file, Sysprep will not remove the detected device drivers. For more information, see the Unattended Windows
Setup Reference.

Displaying RunSynchronous Actions in an Answer File

In Audit mode, you can view the status for RunSynchronous commands that run during auditUser. The AuditUI window
displays the status for commands and provides:

Visual progress to indicate that an installation is continuing and not suspended.

Visual indication of when and where failures occur. This provides quick diagnosis if log files are not created by the
command.

If there are RunSynchronous commands in the answer file in the auditUser configuration pass, a list of the commands are
displayed in the AudiUI window in the order specified by RunSynchronous/RunSynchronousCommand/Order. Each list
item in the UI is either the string from:

RunSynchronous/RunSynchronousCommand/Description (if present)

-OR-
RunSynchronous/RunSynchronousCommand/Path

All RunSynchronous commands are processed in order. If the command succeeds, then its related list item is annotated
with a green checkmark. If the command fails, then its related list item is annotated with a redX. If a reboot is requested,
the AuditUI is redisplayed after the boot but only unprocessed list items are displayed. Previously processed items no
longer appear in the AuditUI. If the list of items in the AuditUI exceeds the height of the display, then the list is clipped to
the display and does not scroll. As a result, some items might not be visible.

Windows Setup interprets the zero and nonzero return codes as status values in the AuditUI. A zero value indicates a
success, while a nonzero value indicates a failure. The return value of the command might affect the behavior of the
Setup, depending on the value of the RunSynchronous/RunSynchronousCommand/WillReboot command.

If RunSynchronous/RunSynchronousCommand/WillReboot is set to Always, then:

If the command returns 0, its related list item is annotated with a green checkmark. A reboot immediately occurs.
If the command returns nonzero, its related list item is annotated with a redX. A reboot immediately occurs.

If RunSynchronous/RunSynchronousCommand/WillReboot is set to Never, then:

If the command returns 0, its related list item is annotated with a green checkmark.
If the command returns nonzero, its related list item is annotated with a redX. A nonzero return value is not
treated as a fatal error when WillReboot is set either to Always or Never.

If RunSynchronous/RunSynchronousCommand/WillReboot is set to OnRequest, then:

2 of 5 20/05/2016 17:32
How Sysprep Works https://technet.microsoft.com/en-us/library/cc766514(v=ws.10).aspx

If the command returns0, its related list item is annotated with a green check mark.
If the command returns1, its related list item is annotated with a green check mark. A reboot immediately occurs.
If the command returns2, its related list item is temporarily annotated with a green checkmark. A reboot
immediately occurs. Following the reboot, the related list item is displayed again in the AuditUI without annotation
because the command is still in process.
If the command returns other values, then a fatal error occurs and a blocking dialog is displayed. If the
Errorhandler.cmd file is present, no dialog is displayed. For more information about Errorhandler.cmd, see Add a
Custom Script to Windows Setup.

Resetting Windows Activation

When you install Windows with a single license product key, you have 30days during which you must activate that
installation of Windows. If you do not activate Windows within the 30day period and do not reset the activation clock,
Windows will enter RFM (Reduced Functionality Mode). This mode prevents users from logging on to the computer until
Windows is activated.

There is no limit to the number of times Sysprep can run on a computer. However, the clock for Windows Product
Activation begins its countdown the first time Windows starts. You can use the sysprep /generalize command to reset
Windows Product Activation a maximum of three times. After the third time you run the sysprep /generalize command,
the clock can no longer be reset.

When you run the sysprep /generalize command, the activation clock will automatically reset. You can bypass resetting
the activation clock by using the SkipRearm setting in the Microsoft-Windows-Security-Licensing-SLC component. This
enables you to run Sysprep multiple times without resetting the activation clock. For more information about this setting,
see the Unattended Windows Setup Reference.

Important

If you anticipate running Sysprep multiple times on a single computer, you must use the SkipRearm setting in the
Microsoft-Windows-Security-Licensing-SLC component to postpone resetting the activation clock. Because you can
reset the activation clock only three times, if you run Sysprep multiple times on a computer, you might run out of
activation clock resets. Microsoft recommends that you use the SkipRearm setting if you plan on running Sysprep
multiple times on a computer.

Volume License and OEM Activation Requirements

For volume licenses, activation clock reset behavior is different, depending on the type of license.

Activation can be reset an unlimited number of times for an activated Key Management Service (KMS) clients. For
non-activated KMS clients, the activation clock can be reset only up to three times, the same as a single license.
Microsoft recommends that KMS clients use the sysprep /generalize command where the value of the SkipRearm
setting is equal to1. After capturing this image, use the sysprep /generalize command where the value of the
SkipRearm setting is equal to0.
For Multiple Activation Keys (MAK) clients, the recommendation is to install the MAK immediately before running
Sysprep the last time before delivering the computer to a customer.

For OEM Activation licenses, activation is not required. OEM Activation is available only to royalty OEMs.

Activating Windows before Shipping to a Customer

Most customers can easily manage activation after receiving their computers. But if you prefer, you can activate the
software on behalf of your customers, making it easier for them to start using their new computers. After activation is
completed, most users will not need to activate their installation again.

To activate Windows for your customer, use the unique Product Key from the certificate of authenticity (COA) label that is
affixed to the specific computer, and activate the computer on behalf of the end user. Run the sysprep /oobe command

3 of 5 20/05/2016 17:32
How Sysprep Works https://technet.microsoft.com/en-us/library/cc766514(v=ws.10).aspx

to prepare the computer for delivery to the customer.

Note

You cannot make an image of an activated Windows installation and duplicate that image to another computer. If you
do, Windows fails to recognize the activation and forces the end user to reactivate the installation manually.

Booting to Audit Mode or Windows Welcome

When WindowsVista boots, there are two modes in which the computer will start:

Windows Welcome Windows Welcome, also called Machine OOBE (out-of-box experience), is the first user
experience and enables end users to customize their Windows installation. End users can create user accounts,
read and accept the Microsoft Software License Terms, and choose their language and time zones.
By default, all Windows installations boot to Windows Welcome first.
The oobeSystem configuration pass runs immediately before Windows Welcome starts. For more information
about this configuration pass, see oobeSystem.
Audit Mode. Audit mode enables OEMs and corporations to add customizations to their Windows images. Audit
mode does not require settings in Windows Welcome to be applied. By bypassing Windows Welcome, you can
access the desktop quicker and perform your customizations. You can add additional device drivers, install
applications, and test the validity of the installation.
In Audit mode, settings in an unattended answer file in the auditSystem and auditUser configuration passes are
processed. For more information about these configuration passes, see auditSystem and auditUser.
If you are running in Audit mode, to configure the installation to boot to Windows Welcome, run the sysprep
/oobe command. OEMs are required to run sysprep /oobe before shipping a computer to an end user. In a
default Windows Vista installation, after installation completes, Windows Welcome starts. However, you can skip
Windows Welcome and boot directly to Audit mode by pressing Ctrl+Shift+F3 at the first Windows Welcome
screen.
For unattended installation, you can configure Windows to boot to Audit mode by using the Microsoft-Windows-
Deployment | Reseal setting in an answer file. For more information, see the Unattended Windows Setup
Reference.

For more information about Audit mode, see Customize Windows in Audit Mode.

Detecting the State of a Windows Image

You can identify the state of a Windows image, whether it will boot to Audit mode, Windows Welcome, or if the image is
still in the process of installation. For more information, see Windows Setup Installation Process.

Sysprep Log Files

Sysprep logs Windows setup actions in different directories, depending on the configuration pass. Because the generalize
pass deletes certain Windows Setup log files, Sysprep logs generalize actions outside the standard Windows Setup log
files. The following table shows the different log file locations that are used by Sysprep.

Item Log Path

generalize %WINDIR%\System32\Sysprep\Panther

specialize %WINDIR%\Panther\

4 of 5 20/05/2016 17:32
How Sysprep Works https://technet.microsoft.com/en-us/library/cc766514(v=ws.10).aspx

Unattended Windows setup actions %WINDIR%\Panther\Unattendgc

See Also
Concepts
What is Sysprep?
Sysprep Command-Line Syntax

Community Additions

2016 Microsoft

5 of 5 20/05/2016 17:32