Import-CMDriver

将设备驱动程序导入驱动程序目录。

语法

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

说明

Import-CMDriver cmdlet 将一个或多个设备驱动程序导入到 Configuration Manager 中的驱动程序目录中。 将设备驱动程序导入目录时,你可以将设备驱动程序添加到驱动程序包或启动映像包。

作为设备驱动程序导入过程的一部分,Configuration Manager 将读取与设备关联的以下信息:

  • 提供程序
  • 版本
  • 签名
  • 支持的硬件
  • 支持的平台

默认情况下,驱动程序以它支持的第一个硬件设备命名。 若要重命名设备驱动程序,请使用Set-CMDriver cmdlet 的 -NewName参数。 受支持的平台列表基于驱动程序的 INF 文件中的信息。 由于此信息的准确性可能会有所不同,因此在将设备驱动程序导入驱动程序目录后,手动验证设备驱动程序是否受支持。

备注

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\> 。 有关详细信息,请参阅 入门

示例

示例 1:在路径中导入所有设备驱动程序

此命令导入位于网络路径 中的所有设备驱动程序 \\Server1\Driver

Import-CMDriver -Path "\\Server1\Driver" -ImportFolder

示例 2:按名称导入设备驱动程序

此命令从网络路径 导入名为 driver.inf 的驱动程序 \\Server1\Driver

Import-CMDriver -Path "\\Server1\Driver\driver.inf"

参数

-AdministrativeCategory

指定类别对象的数组。 若要获取此对象,请使用 Get-CMCategory cmdlet。

将设备驱动程序分配给类别以用于筛选,如台式机或笔记本。

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

-AdministrativeCategoryName

使用此参数只需指定类别的名称,而不是使用 AdministrativeCategory 参数获取和指定类别的对象。 您还可以使用类别名称数组。

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

-BootImagePackage

指定启动映像对象的数组。 若要获取此对象,请使用 Get-CMBootImage cmdlet。

使用此参数将导入的驱动程序添加到指定的启动映像。

仅添加使用 WinPE Windows PE () 启动所需的驱动程序:

  • 确保添加到启动映像的驱动程序与启动映像的体系结构匹配。

  • WinPE 内置了许多驱动程序。 仅添加未包含在 WinPE 中的网络和存储驱动程序。

  • 仅将网络和存储驱动程序添加到启动映像,除非 WinPE 中其他驱动程序有要求。

  • 最好使用具有有效数字签名的驱动程序。

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-DisableWildcardHandling

此参数将通配符视为文字字符值。 不能将其与 ForceWildcardHandling 结合使用

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

-DriverPackage

指定驱动程序包对象的数组。 若要获取此对象,请使用 Get-CMDriverPackage cmdlet。

使用此参数将导入的驱动程序添加到指定的驱动程序包。

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

-EnableAndAllowInstall

启用驱动程序并允许客户端在自动应用驱动程序任务序列步骤 期间 安装它。

添加到驱动程序包的驱动程序不受影响。

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

-ForceWildcardHandling

此参数处理通配符,并且可能会导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用

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

-ImportDuplicateDriverOption

指定 Configuration Manager 如何管理重复的设备驱动程序。

  • AppendCategory:导入驱动程序,将新类别附加到现有类别 - KeepExistingCategory :导入驱动程序并保留现有类别
  • NotImport:不导入驱动程序
  • OverwriteCategory:导入驱动程序并覆盖现有类别
Type:ImportDuplicateDriverOption
Accepted values:NotImport, AppendCategory, KeepExistingCategory, OverwriteCategory
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ImportFolder

添加此参数以导入目标文件夹中的所有设备驱动程序。

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

-Path

指定要导入的驱动程序文件的路径。

Type:String
Aliases:FileName, FilePath, ImportFilePath, Location, UncFileLocation
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SupportedPlatform

指定设备驱动程序适用的可运行支持的平台对象。 若要获取此对象,请使用 Get-CMSupportedPlatform cmdlet。

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

-SupportedPlatformName

指定设备驱动程序可在其中运行的受支持平台名称的数组。 例如,"All Windows 10 (64-bit)"

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

-UpdateBootImageDistributionPoint

指示 Configuration Manager 是否更新其分发点上的启动映像以添加新驱动程序。

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

-UpdateDriverPackageDistributionPoint

如果使用 -DriverPackage 参数,则设置此参数以 $true 更新分配分发点上的驱动程序包。

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

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不运行。

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

输入

输出

IResultObject