Set-CMDriver

模块:

ConfigurationManager

更改设备驱动程序的设置。

语法

Set-CMDriver
   [-AddAdministrativeCategory <IResultObject[]>]
   [-AddBootImagePackage <IResultObject[]>]
   [-AddDriverPackage <IResultObject[]>]
   [-AddSupportedPlatformName <String[]>]
   [-AdministrativeCategory <IResultObject[]>]
   [-ClearAdministrativeCategory]
   [-ClearSupportedPlatformName]
   [-Description <String>]
   [-DriverSource <String>]
   [-EnableAndAllowInstall <Boolean>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-RemoveAdministrativeCategory <IResultObject[]>]
   [-RemoveBootImagePackage <IResultObject[]>]
   [-RemoveDriverPackage <IResultObject[]>]
   [-RemoveSupportedPlatformName <String[]>]
   [-RunOnAnyPlatform]
   [-SupportedPlatformName <String[]>]
   [-UpdateBootImageDistributionPoint <Boolean>]
   [-UpdateDriverDistributionPoint <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMDriver
   [-AddAdministrativeCategory <IResultObject[]>]
   [-AddBootImagePackage <IResultObject[]>]
   [-AddDriverPackage <IResultObject[]>]
   [-AddSupportedPlatformName <String[]>]
   [-AdministrativeCategory <IResultObject[]>]
   [-ClearAdministrativeCategory]
   [-ClearSupportedPlatformName]
   [-Description <String>]
   [-DriverSource <String>]
   [-EnableAndAllowInstall <Boolean>]
   -Id <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveAdministrativeCategory <IResultObject[]>]
   [-RemoveBootImagePackage <IResultObject[]>]
   [-RemoveDriverPackage <IResultObject[]>]
   [-RemoveSupportedPlatformName <String[]>]
   [-RunOnAnyPlatform]
   [-SupportedPlatformName <String[]>]
   [-UpdateBootImageDistributionPoint <Boolean>]
   [-UpdateDriverDistributionPoint <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMDriver
   [-AddAdministrativeCategory <IResultObject[]>]
   [-AddBootImagePackage <IResultObject[]>]
   [-AddDriverPackage <IResultObject[]>]
   [-AddSupportedPlatformName <String[]>]
   [-AdministrativeCategory <IResultObject[]>]
   [-ClearAdministrativeCategory]
   [-ClearSupportedPlatformName]
   [-Description <String>]
   [-DriverSource <String>]
   [-EnableAndAllowInstall <Boolean>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveAdministrativeCategory <IResultObject[]>]
   [-RemoveBootImagePackage <IResultObject[]>]
   [-RemoveDriverPackage <IResultObject[]>]
   [-RemoveSupportedPlatformName <String[]>]
   [-RunOnAnyPlatform]
   [-SupportedPlatformName <String[]>]
   [-UpdateBootImageDistributionPoint <Boolean>]
   [-UpdateDriverDistributionPoint <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-CMDriver cmdlet 更改驱动程序目录中设备驱动程序的设置。

注意

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

示例

示例 1：修改驱动程序

PS XYZ:\> $Driver = Get-CMDriver -Name "cdrom.sys"
PS XYZ:\> Set-CMDriver -InputObject $Driver -NewName "testDriver" -Description "Test configuration" -EnableAndAllowInstall $True -RunOnAnyPlatform $True

第一个命令使用 Get-CMDriver cmdlet 获取名为 cdrom.sys 的设备驱动程序。 命令将对象存储在 $Driver 变量中。

第二个命令重命名驱动程序并添加说明。 命令指定 EnableAndAllowInstall 和 RunOnAnyPlatform 参数的值。

示例 2：使用管道修改驱动程序

PS XYZ:\> Get-CMDriver -Name "cdrom.sys" | Set-CMDriver -NewName testDriver -Description description -EnableAndAllowInstall $True -RunOnAnyPlatform $True

此命令获取名为 cdrom.sys 的驱动程序，然后使用管道运算符将其传递给当前 cmdlet。 当前 cmdlet 重命名驱动程序并添加说明。 命令指定 EnableAndAllowInstall 和 RunOnAnyPlatform 的值。

参数

-AddAdministrativeCategory

指定此 cmdlet 添加到驱动程序的管理类别对象的数组。 若要获取管理类别对象，请使用 Get-CMCategory cmdlet。

类型:	IResultObject[]
别名:	AddAdministrativeCategories
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AddBootImagePackage

指定启动映像对象的数组。 使用此参数指定可以安装设备驱动程序的启动映像。 若要获取启动映像对象，请使用 Get-CMBootImage cmdlet。

类型:	IResultObject[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AddDriverPackage

指定驱动程序包对象的数组。 使用此参数指定 Configuration Manager 用于分发设备驱动程序的驱动程序包。 若要获取驱动程序包对象，请使用 Get-CMDriverPackage cmdlet。

类型:	IResultObject[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AddSupportedPlatformName

{{ Fill AddSupportedPlatformName Description }}

类型:	String[]
别名:	AddSupportedPlatformNames
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AdministrativeCategory

指定管理类别的数组。 将设备驱动程序分配到管理类别以进行筛选，例如“桌面”或“笔记本”类别。

若要获取管理类别对象，请使用 Get-CMCategory cmdlet。

类型:	IResultObject[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ClearAdministrativeCategory

指示此 cmdlet 从驱动程序中删除所有管理类别对象。

类型:	SwitchParameter
别名:	ClearAdministrativeCategories
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ClearSupportedPlatformName

{{ Fill ClearSupportedPlatformName Description }}

类型:	SwitchParameter
别名:	ClearSupportedPlatformNames
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

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

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-Description

指定设备驱动程序的说明。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisableWildcardHandling

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DriverSource

指定驱动程序包源位置。 创建驱动程序包时，包的源位置必须指向另一个驱动程序包未使用的空网络共享。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnableAndAllowInstall

指示 Configuration Manager 是否启用驱动程序并允许计算机安装驱动程序。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ForceWildcardHandling

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Id

指定设备驱动程序的 ID。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-InputObject

指定驱动程序对象。 若要获取驱动程序对象，请使用 Get-CMDriver cmdlet。

类型:	IResultObject
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Name

指定设备驱动程序的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-NewName

指定设备驱动程序的新名称。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PassThru

返回表示驱动程序的 对象。 默认情况下，此 cmdlet 不生成任何输出。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoveAdministrativeCategory

指定此 cmdlet 从驱动程序中删除的管理类别对象的数组。 若要获取管理类别对象，请使用 Get-CMCategory。

类型:	IResultObject[]
别名:	RemoveAdministrativeCategories
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoveBootImagePackage

指定启动映像对象的数组。 使用此参数可删除可安装设备驱动程序的启动映像。 若要获取启动映像对象，请使用 Get-CMBootImage cmdlet。

类型:	IResultObject[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoveDriverPackage

指定驱动程序包对象的数组。 使用此参数可删除 Configuration Manager 用于分发设备驱动程序的驱动程序包。 若要获取驱动程序包对象，请使用 Get-CMDriverPackage cmdlet。

类型:	IResultObject[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoveSupportedPlatformName

{{ Fill RemoveSupportedPlatformName Description }}

类型:	String[]
别名:	RemoveSupportedPlatformNames
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RunOnAnyPlatform

指示设备驱动程序可以在所有平台上运行。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SupportedPlatformName

指定设备驱动程序可在其上运行的平台的名称数组。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UpdateBootImageDistributionPoint

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

类型:	Boolean
别名:	UpdateDistributionPointsForBootImagePackage, UpdateBootImageDistributionPoints
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UpdateDriverDistributionPoint

指示将设备驱动程序添加到驱动程序包时，Configuration Manager 会更新分发点。

类型:	Boolean
别名:	UpdateDistributionPointsForDriverPackage, UpdateDriverDistributionPoints
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

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

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object

相关链接

• Disable-CMDriver
• Enable-CMDriver
• Get-CMDriver
• Import-CMDriver
• Remove-CMDriver
• Get-CMCategory
• Get-CMBootImage
• Get-CMDriverPackage