Import-CMDriver

Imports a device driver into Configuration Manager.

Syntax

Import-CMDriver
      -Path <String>
      [-ImportFolder]
      [-ImportDuplicateDriverOption <ImportDuplicateDriverOption>]
      [-EnableAndAllowInstall <Boolean>]
      [-AdministrativeCategory <IResultObject[]>]
      [-SupportedPlatformName <String[]>]
      [-SupportedPlatform <IResultObject[]>]
      [-DriverPackage <IResultObject[]>]
      [-UpdateDriverPackageDistributionPoint <Boolean>]
      [-BootImagePackage <IResultObject[]>]
      [-UpdateBootImageDistributionPoint <Boolean>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

The Import-CMDriver cmdlet imports one or more device drivers into the driver catalog in Microsoft System Center Configuration Manager. When you import device drivers into the catalog, you can add the device drivers to driver packages or to boot image packages.

As part of the import process for the device driver, Configuration Manager reads the provider, class, version, signature, supported hardware, and supported platform information that is associated with the device. By default, the driver is named after the first hardware device that it supports; however, you can rename the device driver later. The supported platforms list is based on the information in the INF file of the driver. Because the accuracy of this information can vary, manually verify that the device driver is supported after it is imported into the driver catalog.

Examples

Example 1: Import all device drivers in a path

PS C:\>Import-CMDriver -UncFileLocation "\\Server1\Driver" -ImportFolder

This command imports all device drivers located in the network path \\Server1\Driver.

Example 2: Import a device driver by name

PS C:\>Import-CMDriver -UncFileLocation "\\Server1\Driver\driver.inf"

This command imports the driver named driver.inf from the network path \\Server1\Driver.

Required Parameters

-Path
Type:String
Aliases:UncFileLocation, Location
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-AdministrativeCategory

Specifies an array of administrative categories. To obtain an administrative category object, use the Get-CMCategory cmdlet.

Assign the device drivers to an administrative category for filtering purposes, such as Desktops or Notebooks categories.

Type:IResultObject[]
Aliases:AdministrativeCategories
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-BootImagePackage

Specifies an array of boot image objects. To obtain a boot image object, use the Get-CMBootImage cmdlet.

Use this parameter to specify the boot images that can install the imported device drivers.

Type:IResultObject[]
Aliases:BootImagePackages
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DriverPackage

Specifies an array of driver package objects. To obtain a driver package object, use the Get-CMDriverPackage cmdlet.

Use this parameter to specify the driver packages that Configuration Manager uses to distribute the device drivers.

Type:IResultObject[]
Aliases:DriverPackages
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableAndAllowInstall

Indicates whether Configuration Manager enables computers to install the device drivers used with the Auto Apply Driver task sequence step. Drivers added to the driver package are not affected.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ImportDuplicateDriverOption

Specifies how Configuration Manager manages duplicate device drivers. Valid values are:

  • AppendCategory
  • KeepExistingCategory
  • NotImport
  • OverwriteCategory
Type:ImportDuplicateDriverOption
Parameter Sets:NotImport, AppendCategory, KeepExistingCategory, OverwriteCategory
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ImportFolder

Indicates that Configuration Manager imports all the device drivers in the import folder.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SupportedPlatform

Specifies a platform object on which the device driver can run.

Type:IResultObject[]
Aliases:SupportedPlatforms
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SupportedPlatformName

Specifies an array of names of platforms on which the device driver can run.

Type:String[]
Aliases:SupportedPlatformNames
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UpdateBootImageDistributionPoint

Indicates whether Configuration Manager updates boot images on their distribution points to add the new drivers.

Type:Boolean
Aliases:UpdateDistributionPointsForBootImagePackage, UpdateBootImageDistributionPoints
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UpdateDriverPackageDistributionPoint

Indicates whether Configuration Manager adds the drivers to packages and deploys them to distribution points so that computers can use them.

Type:Boolean
Aliases:UpdateDistributionPointsforDriverPackage
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False