Set-CMDriverBootImage

将驱动程序添加到启动映像或从启动映像中删除驱动程序。

语法

Set-CMDriverBootImage
   -BootImageId <String>
   -DriverId <Int32>
   [-PassThru]
   -SetDriveBootImageAction <SetDriveBootImageActionType>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDriverBootImage
   -BootImage <IResultObject>
   -DriverId <Int32>
   [-PassThru]
   -SetDriveBootImageAction <SetDriveBootImageActionType>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDriverBootImage
   -BootImage <IResultObject>
   -DriverName <String>
   [-PassThru]
   -SetDriveBootImageAction <SetDriveBootImageActionType>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDriverBootImage
   -BootImage <IResultObject>
   -Driver <IResultObject>
   [-PassThru]
   -SetDriveBootImageAction <SetDriveBootImageActionType>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDriverBootImage
   -BootImageId <String>
   -DriverName <String>
   [-PassThru]
   -SetDriveBootImageAction <SetDriveBootImageActionType>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDriverBootImage
   -BootImageId <String>
   -Driver <IResultObject>
   [-PassThru]
   -SetDriveBootImageAction <SetDriveBootImageActionType>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDriverBootImage
   -BootImageName <String>
   -DriverId <Int32>
   [-PassThru]
   -SetDriveBootImageAction <SetDriveBootImageActionType>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDriverBootImage
   -BootImageName <String>
   -DriverName <String>
   [-PassThru]
   -SetDriveBootImageAction <SetDriveBootImageActionType>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDriverBootImage
   -BootImageName <String>
   -Driver <IResultObject>
   [-PassThru]
   -SetDriveBootImageAction <SetDriveBootImageActionType>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-CMDriverBootImage cmdlet 将驱动程序添加到启动映像或从启动映像中删除驱动程序。 可以将已导入 Configuration Manager 驱动程序目录的 Windows 设备驱动程序添加到一个或多个启动映像。 应仅添加大容量存储设备驱动程序和网络适配器设备驱动程序来启动映像,因为不需要其他类型的驱动程序,并且会增大启动映像的大小。

注意

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

示例

示例 1:将驱动程序添加到启动映像

PS XYZ:\> Set-CMDriverBootImage -SetDriveBootImageAction AddDriverToBootImage -DriverName "Adaptec Embedded SCSI HostRAID Controller" -BootImageName "Boot image (x64)"

此命令将名为 Adaptec Embedded SCSI HostRAID 控制器的驱动程序添加到名为“启动映像 (x64) 的启动映像。

示例 2:从启动映像中删除驱动程序

PS XYZ:\> Set-CMDriverBootImage -SetDriveBootImageAction RemoveDriverFromBootImage -DriverName "Adaptec SCSI HostRAID Management Processor Device" -BootImageName "Boot image (x64)"

此命令从名为“启动映像”的启动映像中删除名为 Adaptec SCSI HostRAID 管理处理器设备的驱动程序, (x64) 。

参数

-BootImage

指定 CMBootImage 对象。 若要获取 CMBootImage 对象,请使用 Get-CMBootImage cmdlet。

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

-BootImageId

指定启动映像的 ID。

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

-BootImageName

指定启动映像的名称。

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

-Confirm

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

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

-DisableWildcardHandling

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

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

-Driver

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

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

-DriverId

指定驱动程序的 ID。

类型:Int32
别名:Id, CIId, CI_ID
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-DriverName

指定驱动程序的名称。

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

-ForceWildcardHandling

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

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

-PassThru

添加此参数可返回一个对象,该对象表示正在使用的项。 默认情况下,此 cmdlet 可能不会生成任何输出。

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

-SetDriveBootImageAction

指定启动映像操作。 此参数可接受的值为:

  • AddDriverToBootImage
  • RemoveDriverFromBootImage
类型:SetDriveBootImageActionType
接受的值:AddDriverToBootImage, RemoveDriverFromBootImage
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-WhatIf

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

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object