(Winbom)
Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2
[Factory]
The [Factory] section contains entries for managing the actions of Factory.exe. This section is required. Otherwise, Setup ignores the Winbom.ini file.
Use the WinbomType entry to identify the context where Factory.exe and the Winbom.ini file are used.
Answer File Entries for the [Factory] Section
Entry | Description |
---|---|
AutoDetectNetwork |
Specifies whether to scan for network device IDs if an error is encountered in the specified list. |
DoDeviceIDScanOnError |
Specifies whether to scan for network device identifiers if Sysprep encounters an error when processing the devices. |
FactoryComputerName |
Specifies the computer name to use during factory preinstallation. |
Logfile |
Specifies an alternative name and location for the log file. |
Logging |
Specifies whether Factory records its actions in a file specified by the Logfile entry. |
LogLevel |
Specifies the type of messages to log in the log named by the Logfile entry. |
LogPerf |
Specifies whether to record the duration of each state processed by Factory in the log named by the Logfile entry. |
NewWinbom |
Specifies an alternative location for the Winbom.ini file. |
OptimizeShell |
Specifies whether to update the Windows shell settings. |
Password |
Sets the password for the account specified by the UserName entry. |
RebootAfterComputerName |
Specifies whether to restart the computer immediately after the computer name is configured during Factory mode. The computer name is configured by the FactoryComputerName entry in the [Factory] section. |
Reseal |
Specifies the next action of the operating system after the |
ResealFlags |
Appends one or more command-line options to the Sysprep command used in the Reseal entry. |
ResealMode |
Specifies whether to run Sysprep or the user first-run application on the next restart of the computer. |
UserName |
Specifies the name of the account used for operations during Factory mode of Sysprep, including preinstalling applications by using the [OEMRunOnce] section. |
WinbomType |
Specifies how the Winbom.ini file is processed. |
AutoDetectNetwork
Specifies whether to scan for network device IDs if an error is encountered in the specified list.
Syntax
AutoDetectNetwork = Yes | No
Value | Description |
---|---|
Yes |
Scans for network device IDs if an error is encountered in the specified list. |
No |
Does not scan for network device IDs. |
Example
[Factory]
AutoDetectNetwork = No
Comments
The default value is Yes.
DoDeviceIDScanOnError
Specifies whether to scan for network device identifiers if Sysprep encounters an error when processing the devices.
Syntax
DoDeviceIDScanOnError = Yes | No
Value | Description |
---|---|
Yes |
Scans for network device IDs if Sysprep encounters an error while processing the devices. |
No |
Does not scan for network device IDs. |
Example
[Factory]
DoDeviceIDScanOnError = Yes
Comments
The default value is No.
FactoryComputerName
Specifies the computer name to use during factory preinstallation.
Syntax
FactoryComputerName =name | *
Value | Description |
---|---|
name |
Indicates the name of the computer. |
* |
Generates a random computer name. |
Example
[Factory]
FactoryComputerName = *
Comments
If you do not specify this entry, Setup preserves the existing computer name.
You might have to restart the computer for a new computer name to take effect. If further Winbom.ini processing depends on the new computer name, then using the entry RebootAfterComputerName = Yes
will restart the computer immediately.
Logfile
Specifies an alternative name and location for the log file.
Syntax
Logfile =name_of_logfile
Value | Description |
---|---|
name_of_logfile |
The name of the log file. |
Example
[Factory]
Logfile = C:\Winbom.log
Comments
The default log file is named Winbom.log, and is created in the same folder as Factory.exe.
Setup processes this entry when Sysprep starts in Factory mode (Sysprep -factory
) and when Factory starts in Windows PE mode (factory -winpe
) after writable media locations are available.
Logging
Specifies whether Factory records its actions in a file specified by the Logfile entry.
Syntax
Logging = Yes | No
Value | Description |
---|---|
Yes |
Factory records its actions in a log file. |
No |
Factory does not record its actions. |
Example
[Factory]
Logging = No
Comments
The default value is Yes.
LogLevel
Specifies the type of messages to log in the log named by the Logfile entry.
Syntax
LogLevel = 0 | 1 | 2
Value | Description |
---|---|
0 |
Minimal logging, includes errors. |
1 |
More logging, includes some warning messages and errors. |
2 |
Most logging, includes all warnings, errors, and steps completed. |
Example
[Factory]
LogLevel = 1
Comments
The default value is 0.
If you use the entry Logging = Yes
, the LogLevel entry specifies what type of messages to log in the log named by the Logfile entry. Setup records all messages that are at a level less than or equal to the value of the LogLevel entry.
LogPerf
Specifies whether to record the duration of each state processed by Factory in the log named by the Logfile entry.
Syntax
LogPerf = Yes | No
Value | Description |
---|---|
Yes |
Records the duration of each state processed by Factory. |
No |
Does not record the duration of each state. |
Example
[Factory]
LogPerf = No
Comments
The default value is Yes.
If you used the entry Logging = No
, Setup ignores the LogPerf entry.
NewWinbom
Specifies an alternative location for the Winbom.ini file.
Syntax
NewWinbom =path_to_winbom_file
Value | Description |
---|---|
path_to_winbom_file |
Path to the Winbom.ini file. |
Example
[Factory]
NewWinbom = C:\MyFiles
Comments
If the file exists at this location, Factory.exe uses this Winbom.ini file instead of the current Winbom.ini file.
Factory.exe searches for a Winbom.ini file in the following locations in successive order:
The path and file name specified in the following registry key: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Factory\Winbom.
The root of all removable media drives that are not CD drives, such as a floppy disk drive.
The root of all CD drives.
The location of Factory.exe, usually the systemdrive\Sysprep folder.
The systemdrive root.
If Factory.exe is running in Windows PE, the computer does not have network access until it has processed a Winbom.ini file that contains a [WinPE.Net] section.
After locating a Winbom.ini file, Factory.exe reads the value of the WinbomType entry.
If the value of WinbomType is not appropriate in this context, Factory.exe ignores the Winbom.ini file, and continues searching for a Winbom.ini file. If the value of WinbomType is appropriate in this context, Factory.exe reads the value of the NewWinbom entry. If you specify a value for NewWinbom, and a Winbom.ini is in that location, Factory.exe examines that Winbom.ini file for a NewWinbom entry.
This cycle continues a maximum of 10 times or until Factory.exe locates a Winbom.ini file that does not contain a NewWinbom entry, whichever occurs first. Factory.exe then continues to run, using the settings in the last identified Winbom.ini file.
When you run Sysprep in Factory mode, NewWinbom is processed only once at each restart.
When running Factory.exe in Windows PE, after locating the intended Winbom.ini file, the computer connects to the network as specified in the [WinPE.Net] section. Plug and Play installs the network adapter (and only the network adapter), and then Factory.exe installs net services and binds the network protocols.
OptimizeShell
Specifies whether to update the Windows shell settings.
Syntax
OptimizeShell = Yes | No
Value | Description |
---|---|
Yes |
Updates the Windows shell settings based on the amount of physical memory on the computer. |
No |
Does not change any Windows shell settings based on the physical memory of the computer. |
Example
[Factory]
OptimizeShell = No
Comments
The default value is Yes.
The amount of physical system memory determines the availability of some Windows shell features. The threshold for enabling these features is 128 MB of physical memory. If you make an image of a master installation created on a 64-MB computer and place that image on a computer with 128 MB (or more) of memory, Setup might not enable some shell features.
Password
Sets the password for the account specified by the UserName entry.
Syntax
Password =password | *
Value | Description |
---|---|
password |
The password; maximum length is 127 characters. |
* |
The administrator password is blank or NULL. |
Example
[Factory]
Password = HX*CCj3
Comments
If the user credentials required to obtain the Plug and Play drivers are not already in the Domain, UserName, and Password entries in the [PnPDriverUpdate] section, then Factory mode of Sysprep uses the values of the UserName and Password entries in the [Factory] section.
Passwords in Winbom.ini are in plaintext. This could be a security risk. In general, use accounts with the lowest necessary rights on the distribution share. Either set the UserName entry in the [Factory] section to the Guest account on the distribution share (this requires that the Guest account is enabled) or use an account that is a member of the Users group. Add that account to the users of the distribution share with Read rights only.
RebootAfterComputerName
Specifies whether to restart the computer immediately after the computer name is configured during Factory mode. The computer name is configured by the FactoryComputerName entry in the [Factory] section.
Syntax
RebootAfterComputerName = Yes | No
Value | Description |
---|---|
Yes |
Restarts the computer immediately. |
No |
Does not restart the computer, and the new computer name might not take effect until the next restart. |
Example
[Factory]
RebootAfterComputerName = Yes
Comments
The default value is No.
If you do not specify this value, the computer does not restart, and the new computer name might not take effect until the next restart.
Reseal
Specifies the next action of the operating system after the Sysprep -factory
command finishes. The options specified in the ResealFlags entry append to the Sysprep command.
Syntax
Reseal = Yes | No | ForceShutdown | Reboot | Shutdown
Value | Description |
---|---|
Yes |
Prepares the operating system as specified by the ResealMode entry, then immediately shuts down the computer without any user intervention. The value of the ResealMode entry must be either Mini or OOBE. |
No |
Does not run Sysprep. |
ForceShutdown |
Prepares the operating system as specified by the ResealMode entry, and immediately shuts down the computer without any user intervention and without turning off the power to the computer. This option applies to non-ACPI computers. |
Reboot |
Prepares the operating system as specified by the ResealMode entry, and immediately restarts the computer to the first-run experience (either Windows Welcome or Mini-Setup) without any user intervention. Use this option for testing in the factory environment. |
Shutdown |
Prepares the operating system as specified by the ResealMode entry, and immediately shuts down and turns off the computer without any user intervention. |
Example
[Factory]
Reseal = Yes
Comments
If no value is given for the Reseal entry, Sysprep runs and displays its graphical user interface.
ResealFlags
Appends one or more command-line options to the Sysprep command used in the Reseal entry.
Syntax
ResealFlags = -activated [-nosidgen][-pnp]
Value | Description |
---|---|
-activated |
Does not reset the clock for Windows Product Activation (WPA). If you already successfully activated the operating system, do not reset the status to nonactivated. |
-nosidgen |
Runs Sysprep without generating new security IDs (SIDs). You must use this option if you do not duplicate the computer on which you run Sysprep or if you preinstall domain controllers. |
-pnp |
Run the full Plug and Play device enumeration and installation during the Mini-Setup stage. This command-line option has no effect if the first-run experience is Windows Welcome. |
Example
[Factory]
ResealFlags = -activated -nosidgen
Comments
You must separate multiple command-line options with a space.
Use the Reseal and ResealMode entries instead of the ResealFlags entry to initiate the functionality of other Sysprep command-line parameters, such as -factory
, -noreboot
, -reboot
, -reseal
, or -quiet
.
ResealMode
Specifies whether to run Sysprep or the user first-run application on the next restart of the computer.
Syntax
ResealMode = Audit | Factory | Mini | OOBE
Value | Description |
---|---|
Audit |
Runs |
Factory |
Runs |
Mini |
Runs Mini-Setup on the next restart of the computer. The default value for Windows XP 64-Bit Edition and the Windows Server 2003 family. Not valid for Windows XP Home Edition. |
OOBE |
Runs Windows Welcome (Msoobe.exe) on the next restart of the computer. The default value for Windows XP Home Edition and Windows XP Professional. Not valid for Windows XP 64-Bit Edition or Windows Server 2003. |
Example
[Factory]
ResealMode = Audit
Comments
The default value is OOBE on Windows XP Home Edition and Windows XP Professional, and Mini on Windows XP 64-Bit Edition and Windows Server 2003 family.
Windows Welcome is always the first-run application for the Windows XP Home Edition version, and Mini-Setup is always the first-run application for all versions of Windows Server 2003 family.
If you use the entry Reseal = No
, Setup ignores this entry. If you use the entry Reseal = Yes
, the value of the ResealMode entry must be either Mini or OOBE.
UserName
Specifies the name of the account used for operations during Factory mode of Sysprep, including preinstalling applications by using the [OEMRunOnce] section.
Syntax
UserName =name
Value | Description |
---|---|
name |
User name in Domain\Name format. |
Example
[Factory]
UserName = DomainHQ\ScottG
Comments
If you need to specify a domain for this account, include that domain as part of the value of the UserName entry. Specify the password for this account in the Password entry.
If the user credentials required to obtain the Plug and Play drivers and these credentials are not already in the Domain, UserName, and Password entries in [PnPDriverUpdate], the Factory mode of Sysprep uses the values of the UserName and Password entries in the [Factory] section.
WinbomType
Specifies how the Winbom.ini file is processed.
Syntax
WinbomType = Factory | OOBE | WinPE | none
Value | Description |
---|---|
Factory |
Specifies that the Winbom.ini file is processed only in |
OOBE |
Specifies that the Winbom.ini file is processed only in Windows Welcome. |
WinPE |
Specifies that the Winbom.ini file is processed only when the operating system is Windows PE. The most common use of this entry is when the computer starts in Factory mode from an operating system image located on the hard drive, a CD is present in the CD drive, and the CD contains a Winbom.ini file. If the Winbom.ini file on the CD contains the entry |
none |
If the NewWinbom entry is not present, then there are no restrictions on which tools can use the Winbom.ini file. |
Example
[Factory]
WinbomType = Factory
Comments
For the specific sections and entries in Winbom.ini that are processed for each value of WinbomType, and the sequence of those processes, see “Processing Winbom.ini” in “How Sysprep Works.”