Set-CMDriver
更改设备驱动程序的设置。
语法
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。
| Type: | IResultObject[] |
| Aliases: | AddAdministrativeCategories |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AddBootImagePackage
指定启动映像对象的数组。 使用此参数指定可以安装设备驱动程序的启动映像。 若要获取启动映像对象，请使用 Get-CMBootImage cmdlet。
| Type: | IResultObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AddDriverPackage
指定驱动程序包对象的数组。 使用此参数指定Configuration Manager用于分发设备驱动程序的驱动程序包。 若要获取驱动程序包对象，请使用 Get-CMDriverPackage cmdlet。
| Type: | IResultObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AddSupportedPlatformName
{{ Fill AddSupportedPlatformName Description }}
| Type: | String[] |
| Aliases: | AddSupportedPlatformNames |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AdministrativeCategory
指定管理类别的数组。 将设备驱动程序分配到管理类别以进行筛选，例如“桌面”或“笔记本”类别。
若要获取管理类别对象，请使用 Get-CMCategory cmdlet。
| Type: | IResultObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClearAdministrativeCategory
指示此 cmdlet 从驱动程序中删除所有管理类别对象。
| Type: | SwitchParameter |
| Aliases: | ClearAdministrativeCategories |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClearSupportedPlatformName
{{ Fill ClearSupportedPlatformName Description }}
| Type: | SwitchParameter |
| Aliases: | ClearSupportedPlatformNames |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
指定设备驱动程序的说明。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DriverSource
指定驱动程序包源位置。 创建驱动程序包时，包的源位置必须指向另一个驱动程序包未使用的空网络共享。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableAndAllowInstall
指示Configuration Manager是否启用驱动程序并允许计算机安装驱动程序。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
指定设备驱动程序的 ID。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
指定驱动程序对象。 若要获取驱动程序对象，请使用 Get-CMDriver cmdlet。
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
指定设备驱动程序的名称。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewName
指定设备驱动程序的新名称。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
返回表示驱动程序的 对象。 默认情况下，此 cmdlet 不生成任何输出。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveAdministrativeCategory
指定此 cmdlet 从驱动程序中删除的管理类别对象的数组。 若要获取管理类别对象，请使用 Get-CMCategory。
| Type: | IResultObject[] |
| Aliases: | RemoveAdministrativeCategories |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveBootImagePackage
指定启动映像对象的数组。 使用此参数可删除可安装设备驱动程序的启动映像。 若要获取启动映像对象，请使用 Get-CMBootImage cmdlet。
| Type: | IResultObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveDriverPackage
指定驱动程序包对象的数组。 使用此参数可删除Configuration Manager用于分发设备驱动程序的驱动程序包。 若要获取驱动程序包对象，请使用 Get-CMDriverPackage cmdlet。
| Type: | IResultObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveSupportedPlatformName
{{ Fill RemoveSupportedPlatformName Description }}
| Type: | String[] |
| Aliases: | RemoveSupportedPlatformNames |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunOnAnyPlatform
指示设备驱动程序可以在所有平台上运行。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SupportedPlatformName
指定设备驱动程序可在其上运行的平台的名称数组。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpdateBootImageDistributionPoint
指示Configuration Manager是否更新分发点上的启动映像以添加新驱动程序。
| Type: | Boolean |
| Aliases: | UpdateDistributionPointsForBootImagePackage, UpdateBootImageDistributionPoints |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpdateDriverDistributionPoint
指示在将设备驱动程序添加到驱动程序包时，Configuration Manager更新分发点。
| Type: | Boolean |
| Aliases: | UpdateDistributionPointsForDriverPackage, UpdateDriverDistributionPoints |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
System.Object
相关链接
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈