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:按名称导入设备驱动程序
此命令从网络路径 \\Server1\Driver
导入名为 driver.inf 的驱动程序。
Import-CMDriver -Path "\\Server1\Driver\driver.inf"
参数
-AdministrativeCategory
指定类别对象的数组。 若要获取此对象,请使用 Get-CMCategory cmdlet。
将设备驱动程序分配到类别以进行筛选,例如桌面或笔记本。
类型: | IResultObject[] |
别名: | AdministrativeCategories |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-AdministrativeCategoryName
使用此参数只是指定类别的名称,而不是使用 AdministrativeCategory 参数获取和指定类别的对象。 还可以使用类别名称数组。
类型: | String[] |
别名: | AdministrativeCategoryNames |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-BootImagePackage
指定启动映像对象的数组。 若要获取此对象,请使用 Get-CMBootImage cmdlet。
使用此参数将导入的驱动程序添加到指定的启动映像。
仅添加 Windows PE (WinPE) 启动所需的驱动程序:
确保添加到启动映像的驱动程序与启动映像的体系结构匹配。
WinPE 已附带许多内置驱动程序。 仅添加 WinPE 中未包括的网络和存储驱动程序。
仅将网络和存储驱动程序添加到启动映像,除非 WinPE 中的其他驱动程序有要求。
最好使用具有有效数字签名的驱动程序。
类型: | IResultObject[] |
别名: | BootImagePackages |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DriverPackage
指定驱动程序包对象的数组。 若要获取此对象,请使用 Get-CMDriverPackage cmdlet。
使用此参数将导入的驱动程序添加到指定的驱动程序包。
类型: | IResultObject[] |
别名: | DriverPackages |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-EnableAndAllowInstall
启用驱动程序并允许客户端在 “自动应用驱动程序 ”任务序列步骤中安装它。
添加到驱动程序包的驱动程序不受影响。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ImportDuplicateDriverOption
指定 Configuration Manager 如何管理重复的设备驱动程序。
-
AppendCategory
:导入驱动程序并将新类别追加到现有类别- KeepExistingCategory
:导入驱动程序并保留现有类别 -
NotImport
:不导入驱动程序 -
OverwriteCategory
:导入驱动程序并覆盖现有类别
类型: | ImportDuplicateDriverOption |
接受的值: | NotImport, AppendCategory, KeepExistingCategory, OverwriteCategory |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ImportFolder
添加此参数以导入目标文件夹中的所有设备驱动程序。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Path
指定要导入的驱动程序文件的路径。
类型: | String |
别名: | FileName, FilePath, ImportFilePath, Location, UncFileLocation |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-SupportedPlatform
指定设备驱动程序适用于且可运行的受支持平台对象。 若要获取此对象,请使用 Get-CMSupportedPlatform cmdlet。
类型: | IResultObject[] |
别名: | SupportedPlatforms |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SupportedPlatformName
指定设备驱动程序可在其上运行的受支持平台名称的数组。 例如,"All Windows 10 (64-bit)"
。
类型: | String[] |
别名: | SupportedPlatformNames |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-UpdateBootImageDistributionPoint
指示 Configuration Manager 是否在其分发点上更新启动映像以添加新驱动程序。
类型: | Boolean |
别名: | UpdateDistributionPointsForBootImagePackage, UpdateBootImageDistributionPoints |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-UpdateDriverPackageDistributionPoint
如果使用 -DriverPackage 参数,请将此参数设置为 $true
以更新分配的分发点上的驱动程序包。
类型: | Boolean |
别名: | UpdateDistributionPointsforDriverPackage |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
None
输出
IResultObject