Condividi tramite


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 i driver di dispositivo Windows importati nel catalogo driver di Configuration Manager a 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 i cmdlet di Configuration Manager dall'unità del sito di 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 .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-BootImageId

Specifica l'ID di un'immagine di avvio.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-BootImageName

Specifica il nome di un'immagine di avvio.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Driver

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

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DriverId

Specifica l'ID di un driver.

Tipo:Int32
Alias:Id, CIId, CI_ID
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DriverName

Specifica il nome di un driver.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SetDriveBootImageAction

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

  • AddDriverToBootImage
  • RemoveDriverFromBootImage
Tipo:SetDriveBootImageActionType
Valori accettati:AddDriverToBootImage, RemoveDriverFromBootImage
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object