Set-CMDriverBootImage

Adds a driver to a boot image or removes a driver from a boot image.

Syntax

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

Description

The Set-CMDriverBootImage cmdlet adds a driver to a boot image or removes a driver from a boot image. You can add Windows device drivers that you have imported into the Microsoft System Center Configuration Manager driver catalog to one or more boot images. You should add only mass storage device drivers and network adapter device drivers to boot images because other types of drivers are not needed and will increase the size of the boot image.

Examples

Example 1: Add a driver to a boot image

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

This command adds the driver named Adaptec Embedded SCSI HostRAID Controller to the boot image named Boot image (x64).

Example 2: Remove a driver from a boot image

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

This command removes the driver named Adaptec SCSI HostRAID Management Processor Device from the boot image named Boot image (x64).

Required Parameters

-BootImage

Specifies a CMBootImage object. To obtain a CMBootImage object, use the Get-CMBootImage cmdlet.

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-BootImageId

Specifies the ID of a boot image.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-BootImageName

Specifies the name of a boot image.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Driver

Specifies a driver object. To obtain a CMDriver object, use the Get-CMDriver cmdlet.

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-DriverId

Specifies the ID of a driver.

Type:Int32
Aliases:Id, CIId, CI_ID
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DriverName

Specifies the name of a driver.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SetDriveBootImageAction

Specifies the boot image action. The acceptable values for this parameter are:

  • AddDriverToBootImage
  • RemoveDriverFromBootImage
Type:SetDriveBootImageActionType
Parameter Sets:AddDriverToBootImage, RemoveDriverFromBootImage
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

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

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

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

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

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

Returns the current working object. By default, this cmdlet does not generate any output.

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

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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