Set-CMDriverBootImage

Aggiunge un driver a un'immagine di avvio o rimuove un driver da un'immagine di avvio.

Sintassi

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>]

Descrizione

Il cmdlet Set-CMDriverBootImage aggiunge un driver a un'immagine di avvio o rimuove un driver da un'immagine di avvio. È possibile aggiungere driver di dispositivo Windows importati nel catalogo dei driver di Configuration Manager in una o più immagini di avvio. È consigliabile aggiungere solo i driver di dispositivo di archiviazione di massa e i driver di dispositivo della scheda di rete alle immagini di avvio perché altri tipi di driver non sono necessari e aumenteranno le dimensioni dell'immagine di avvio.

Nota

Eseguire Configuration Manager cmdlet dall'unità del sito Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Aggiungere un driver a un'immagine di avvio

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

Questo comando aggiunge il driver denominato Adaptec Embedded SCSI HostRAID Controller all'immagine di avvio denominata Boot image (x64).

Esempio 2: Rimuovere un driver da un'immagine di avvio

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

Questo comando rimuove il driver denominato Adaptec SCSI HostRAID Management Processor Device dall'immagine di avvio denominata Boot image (x64).

Parametri

-BootImage

Specifica un oggetto CMBootImage . Per ottenere un oggetto CMBootImage , usare il cmdlet Get-CMBootImage .

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BootImageId

Specifica l'ID di un'immagine di avvio.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BootImageName

Specifica il nome di un'immagine di avvio.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

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

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

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

-Driver

Specifica un oggetto driver. Per ottenere un oggetto CMDriver , usare il cmdlet Get-CMDriver .

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DriverId

Specifica l'ID di un driver.

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

-DriverName

Specifica il nome di un driver.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

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

-PassThru

Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

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

-SetDriveBootImageAction

Specifica l'azione dell'immagine di avvio. I valori consentiti per questo parametro sono:

  • AddDriverToBootImage
  • RemoveDriverFromBootImage
Type:SetDriveBootImageActionType
Accepted values:AddDriverToBootImage, RemoveDriverFromBootImage
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

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

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object