Export (0) Print
Expand All

[Factory] (Winbom)

Updated: March 28, 2003

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 Sysprep -factory command finishes. The options specified in the ResealFlags entry append to the Sysprep command.

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:

  1. The path and file name specified in the following registry key: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Factory\Winbom.

  2. The root of all removable media drives that are not CD drives, such as a floppy disk drive.

  3. The root of all CD drives.

  4. The location of Factory.exe, usually the systemdrive\Sysprep folder.

  5. 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 Sysprep -audit on the next restart of the computer.

Factory

Runs Sysprep -factory on the next restart of the computer.

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 Sysprep -factory.

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 WinbomType = WinPE, Sysprep in Factory mode ignores the Winbom.ini file that contains this entry and searches for another file, as specified by the search order listed for the NewWinbom 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.”

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft