9/16/2016

HowSysprepWorks

This documentation is archived and is not being maintained.

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 commandline arguments.
If no commandline 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.

https://technet.microsoft.com/enus/library/cc766514(v=ws.10).aspx

1/5

9/16/2016

HowSysprepWorks

For more information, see How Configuration Passes Work. For more information about Sysprep commandline options, see
Sysprep CommandLine Syntax.

Caching Answer Files to the Computer

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 CommandLine 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 MicrosoftWindowsPnPSysprep 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.
https://technet.microsoft.com/enus/library/cc766514(v=ws.10).aspx

2/5

9/16/2016

HowSysprepWorks

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:
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 MicrosoftWindowsSecurityLicensingSLC 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
WindowsSecurityLicensingSLC 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
https://technet.microsoft.com/enus/library/cc766514(v=ws.10).aspx

3/5

9/16/2016

HowSysprepWorks

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 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 outofbox 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 MicrosoftWindows
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

https://technet.microsoft.com/enus/library/cc766514(v=ws.10).aspx

4/5

9/16/2016

HowSysprepWorks

generalize

%WINDIR%\System32\Sysprep\Panther

specialize

%WINDIR%\Panther\

Unattended Windows setup actions

%WINDIR%\Panther\Unattendgc

See Also
Concepts
What is Sysprep?
Sysprep CommandLine Syntax
2016 Microsoft

https://technet.microsoft.com/enus/library/cc766514(v=ws.10).aspx

5/5