Driver Servicing Command-Line Options (Standard 8)

7/8/2014

Review the driver servicing command-line options for Deployment Image Servicing and Management (DISM) in Windows Embedded 8 Standard (Standard 8).

The driver-servicing commands can be used on an offline image to add and remove drivers based on the .inf file, and can be used on a running operating system (online) to enumerate drivers. Microsoft Windows Installer or other driver-package types (such as .exe files) are not supported.

You can specify a directory where the driver .inf files are located, or you can point to a driver by specifying the name of the .inf file.

The following is the base syntax for servicing a Windows image using Deployment Image Servicing and Management (DISM):

DISM {**/Image:**path_to_image_directory | /Online} [dism_options] {servicing_command} [servicing_arguments]

The following driver-servicing options are available for an offline image:

DISM/Image:path_to_image_directory [/Get-Drivers | /Get-DriverInfo | /Add-Driver | /Remove-Driver]

The following driver-servicing options are available for a running operating system:

DISM/Online [/Get-Drivers | /Get-DriverInfo]

The following table provides a description of how each driver-servicing option can be used. These options are not case sensitive.

Option

Argument

Description

/Get-Help

/?

 

Displays information about available DISM command-line options and arguments. When used immediately after a command-line option, information about the option and its arguments is displayed.

Additional topics might become available when an image is specified.

/Get-Drivers

/All

/Format:Table

/Format:List

Displays basic information about driver packages in the online or offline image.

By default, only third-party drivers will be listed. Use the /all argument to display information about default drivers and third-party drivers. Use the /Format:Table or /Format:List arguments to display the output as a table or a list.

If you point to an image, you can find out what drivers are in the image, as well as the state of the drivers (installed or staged).

/Get-DriverInfo

/Driver:folder_containing_driver.inf

/Driver:path_to_driver.inf

Adds third-party driver packages to an offline Windows image.

When you use the /Driver option to point to a folder, .inf files that are not valid driver packages are ignored. These files are reported on the console when the command runs, and a warning is included in the log file. You will not receive an error message.

/Add-Driver

/Driver:folder_containing_driver.inf

/Driver:path_to_driver.inf

/Recurse

/ForceUnsigned

Adds third-party driver packages to an offline Windows image.

When you use the /Driver option to point to a folder, INF files that are not valid driver packages are ignored. These files are reported on the console when the command runs, and a warning is included in the log file. You will not receive an error message.

If you point to a path and use the /Recurse option, all subfolders are queried for drivers to add.

For test purposes, you can use /ForceUnsigned to add unsigned drivers and override the requirement that drivers installed on X64-based computers must have a digital signature.

/Remove-Driver

/Driver:path_to_installed_driver1.inf

Removes third-party drivers from an offline image.

When third-party drivers are added, they have names like Oem0.inf, Oem1.inf, and so on. You must specify the published name, for example, Oem1.inf, to remove the driver. You cannot remove default drivers.

JJ979872.Caution(en-us,WinEmbedded.81).gifCaution:
Removing a boot-critical driver package can make the offline Windows image unbootable.

You can specify multiple drivers on the command line by using the /Driver option multiple times.

Limitations

  • The driver-servicing command supports only .inf files. Windows Installer or other driver-package types (such as .exe files) are not supported.
  • Drivers are installed in the order that they are listed in the command line.

See Also

Concepts

Deployment Image Servicing and Management (DISM) Command-Line Options
What Is Deployment Image Servicing and Management?
How Deployment Image Servicing and Management (DISM) Works
Operating System Module Servicing Command-Line Options
Windows PE Servicing Command-Line Options
Operating System Package Servicing Command-Line Options
International Servicing Command-Line Options