(Winbom)

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2

[PnPDriverUpdate]

The [PnPDriverUpdate] section contains entries for specifying optional user credentials and a source location of drivers to place on an installed image. You can supply updated drivers from either local media or a network. On the next restart of the operating system, Plug and Play installs the updated drivers.

If you use a specific user account in order to access files from a remote location, then you must specify values for the UserName, Password, and Domain entries to create a connection to the remote location. If you do not specify these values, Sysprep in Factory mode uses the values specified by the UserName and Password entries in the [Factory] section of Winbom.ini.

When the computer restarts in Factory mode, Setup copies the drivers while the computer is still in system context, before Plug and Play detection occurs.

You must use digitally signed drivers that have a higher installation rank than drivers provided in the box for the same hardware.

Answer-file entries for the [PnPDriverUpdate] section

DevicePath

Specifies one or more local folders to append to the device path in the registry, along with any folders listed in the [PnPDrivers] section.

Syntax

DevicePath = path_and_folder_name[;path_and_folder_name]...

Example

[PnPDriverUpdate]
DevicePath = C:\MyFiles\Device1; C:\MyFiles\Device2

Comments

By default, no change is made to the existing setting unless you specify a value for this entry.

Paths are relative to the TargetRoot entry.

Use the DevicePath entry when you need to update only the device path containing the folders to which you manually copied driver files. To copy files to these folders at the same time, specify additional folders in the [PnPDrivers] section, instead of in the DevicePath entry.

Domain

Specifies the domain in which the user specified by the UserName entry logs on.

Syntax

Domain = domain

Example

[PnPDriverUpdate]
Domain = contoso.com

Comments

None

Password

Specifies a valid password for the user specified by the UserName entry.

Syntax

Password = password

Example

[PnPDriverUpdate]
Password = ABC*123

Comments

None

TargetRoot

Specifies the location on the destination computer to which the new drivers will be copied.

Syntax

TargetRoot = path

Example

[PnPDrivers]
a:\video\video2000 = Video2000
\\server\share\video\ati\allinone = AllinOne
FLOPPY:\ = audio
CDROM:\ = drivers

[PnPDriverUpdate]
TargetRoot = %systemroot%\NewPlace

In this example, Setup copies files as follows:

• Files in a:\video\video2000 are copied to systemroot\NewPlace\Video2000.

• Files in \\server\share\video\ati\allinone are copied to systemroot\NewPlace\AllinOne.

• Files on the floppy disk are copied to systemroot\NewPlace\Audio.

• Files in the \Drivers subfolder on the CD are copied to systemroot\NewPlace.

You can specify subfolders within the TargetRoot entry with the value of subfolder_name in the [PnPDrivers] section.

Comments

The default value is systemroot\Drivers.

UpdateInstalledDrivers

Specifies whether to call Plug and Play after the [PnPDrivers] section processes to re-enumerate all the installed drivers and install any updated drivers in the driver path.

Syntax

UpdateInstalledDrivers = Yes | No

Example

[PnPDriverUpdate]
UpdateInstalledDrivers = %systemroot%\NewPlace

Comments

The default value is Yes if you configure the destination computer to run Windows Welcome, or if the [PnPDrivers] section is present.

The default value is No if you do not configure the destination computer to run Windows Welcome, or if the [PnPDrivers] section is not present.

UserName

Specifies a valid user name that has appropriate permissions to connect to a shared folder and copy files from it, using the password specified by the Password entry.

Syntax

UserName = username

Example

[PnPDriverUpdate]
UserName = ScottG

Comments

If necessary, use the Domain entry to specify the domain.

WaitForPnP

Specifies whether Factory.exe waits until Plug and Play detection finishes before processing the remainder of the Winbom.ini file.

Syntax

WaitForPnP = Yes | No

Example

[PnPDriverUpdate]
WaitForPnP = Yes

Comments

The default value is No.