/add-ImageDriverPackages

  • Article

Applies To: Windows Server 2008 R2

Adds driver packages from the driver store to a boot image. The image version must be Windows 7 or Windows Server 2008 R2 or later.

For examples of how you can use this command, see Examples .

Syntax

WDSUTIL /Add-ImageDriverPackages [/Server:<Server name>] /Image:<Image name> /ImageType:Boot /Architecture:{x86 | ia64 | x64} 
[/Filename:<File name>] /FilterType:<Filter Type> /Operator:{Equal | NotEqual | GreaterOrEqual | LessOrEqual | Contains} /Value:<Value> [/Value:<Value> ...]

Parameters

Parameter Description

/Server:<Server name>

Specifies the name of the server. This can be the NetBIOS name or the FQDN. If no server name is specified, the local server is used.

/Image:<Image name>

Specifies the name of the image to add the driver to.

/ImageType:Boot

Specifies the type of image to add the driver to. Driver packages can be added only to boot images.

/Architecture:{x86 | ia64 | x64}

Specifies the architecture of the boot image. Because it is possible to have the same image name for boot images in different architectures, you should specify the architecture to ensure the correct image is used.

/Filename:<File name>

Specifies the file name. If the image cannot be uniquely identified by name, the file name must be specified.

/FilterType:<Filter Type>

Specifies the attribute of the driver package to search for. You can specify multiple attributes in a single command. You must also specify /Operator and /Value with this option.

<Filter Type> can be one of the following:

PackageId

PackageName

PackageEnabled

PackageDateAdded

PackageInfFilename

PackageClass

PackageProvider

PackageArchitecture

PackageLocale

PackageSigned

PackageDatePublished

PackageVersion

DriverDescription

DriverManufacturer

DriverHardwareId

DriverCompatibleId

DriverExcludeId

DriverGroupId

DriverGroupName

/Operator:{Equal | NotEqual | GreaterOrEqual | LessOrEqual | Contains}

The relationship between the attribute and the values. You can only specify Contains with string attributes. You can only specify GreaterOrEqual and LessOrEqual with date and version attributes.

/Value:<Value>

Specifies the value to search for relative to the specified <Attribute>. You can specify multiple values for a single /FilterType. The list below outlines the attributes that you can specify for each filter. For more information about these attributes, see Driver and Package Attributes (https://go.microsoft.com/fwlink/?LinkId=166895).

  • PackageId - Specify a valid GUID. For example: {4d36e972-e325-11ce-bfc1-08002be10318}.

  • PackageName – Specify any string value.

  • PackageEnabled - Specify Yes or No.

  • PackageDateAdded - Specify the date in the following format: YYYY/MM/DD

  • PackageInfFilename – Specify any string value.

  • PackageClass - Specify a valid class name or class GUID. For example: DiskDrive, Net, or {4d36e972-e325-11ce-bfc1-08002be10318}.

  • PackageProvider – Specify any string value.

  • PackageArchitecture - Specify x86, x64, or ia64.

  • PackageLocale - Specify a valid language identifier. For example: en-US or es-ES.

  • PackageSigned - Specify Yes or No.

  • PackageDatePublished - Specify the date in the following format: YYYY/MM/DD

  • PackageVersion - Specify the version in the following format: a.b.x.y. For example: 6.1.0.0

  • DriverDescription – Specify any string value.

  • DriverManufacturer – Specify any string value.

  • DriverHardwareId - Specify any string value.

  • DriverCompatibleId - Specify any string value.

  • DriverExcludeId - Specify any string value.

  • DriverGroupId - Specify a valid GUID. For example: {4d36e972-e325-11ce-bfc1-08002be10318}.

  • DriverGroupName – Specify any string value.

Examples

To add driver packages to a boot image, type one of the following:

WDSUTIL /Add-ImageDriverPackages /Image:"WinPE Boot Image" /ImageType:Boot /Architecture:x86 /FilterType:DriverGroupName /Operator:Equal /Value:x86Bus /FilterType:PackageProvider /Operator:Contains /Value:Provider1 /FilterType:PackageVersion /Operator:GreaterOrEqual /Value:6.1.0.0

WDSUTIL /verbose /Add-ImageDriverPackages /Image: "WinPE Boot Image" /Server:MyWDSServer /ImageType:Boot /Architecture:x64 /FilterType:PackageClass /Operator:Equal /Value:Net /FilterType:DriverManufacturer /Operator:NotEqual /Value:Name1 /Value:Name2 /FilterType:PackageDateAdded /Operator:LessOrEqual /Value:2008/01/01

WDSUTIL /verbose /Add-ImageDriverPackages /Image:"WinPE Boot Image" /Server:MyWDSServer /ImageType:Boot /Architecture:x64 /FilterType:PackageClass /Operator:Equal /Value:Net /Value:System /Value:DiskDrive /Value:HDC /Value:SCSIAdapter

Additional references

Command-Line Syntax Key

/add-ImageDriverPackage

/add-AllDriverPackages