Set-CMDriverBootImage
Ajoute un pilote à une image de démarrage ou supprime un pilote d’une image de démarrage.
Syntaxe
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>] Description
L’applet de commande Set-CMDriverBootImage ajoute un pilote à une image de démarrage ou supprime un pilote d’une image de démarrage. Vous pouvez ajouter des pilotes de périphérique Windows que vous avez importés dans le catalogue de pilotes Configuration Manager à une ou plusieurs images de démarrage. Vous devez ajouter uniquement des pilotes de périphérique de stockage de masse et des pilotes de périphérique de carte réseau aux images de démarrage, car d’autres types de pilotes ne sont pas nécessaires et augmenteront la taille de l’image de démarrage.
Remarque
Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.
Exemples
Exemple 1 : Ajouter un pilote à une image de démarrage
PS XYZ:\> Set-CMDriverBootImage -SetDriveBootImageAction AddDriverToBootImage -DriverName "Adaptec Embedded SCSI HostRAID Controller" -BootImageName "Boot image (x64)"Cette commande ajoute le pilote nommé Adaptec Embedded SCSI HostRAID Controller à l’image de démarrage nommée Image de démarrage (x64).
Exemple 2 : Supprimer un pilote d’une image de démarrage
PS XYZ:\> Set-CMDriverBootImage -SetDriveBootImageAction RemoveDriverFromBootImage -DriverName "Adaptec SCSI HostRAID Management Processor Device" -BootImageName "Boot image (x64)"Cette commande supprime le pilote nommé Adaptec SCSI HostRAID Management Processor Device de l’image de démarrage nommée Image de démarrage (x64).
Paramètres
-BootImage
Spécifie un objet CMBootImage . Pour obtenir un objet CMBootImage , utilisez l’applet de commande Get-CMBootImage .
| Type: | IResultObject |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-BootImageId
Spécifie l’ID d’une image de démarrage.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-BootImageName
Spécifie le nom d’une image de démarrage.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Confirm
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
| Type: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DisableWildcardHandling
Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Driver
Spécifie un objet pilote. Pour obtenir un objet CMDriver , utilisez l’applet de commande Get-CMDriver .
| Type: | IResultObject |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-DriverId
Spécifie l’ID d’un pilote.
| Type: | Int32 |
| Alias: | Id, CIId, CI_ID |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DriverName
Spécifie le nom d’un pilote.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ForceWildcardHandling
Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PassThru
Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette applet de commande peut ne pas générer de sortie.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SetDriveBootImageAction
Spécifie l’action d’image de démarrage. Les valeurs acceptables pour ce paramètre sont les suivantes :
- AddDriverToBootImage
- RemoveDriverFromBootImage
| Type: | SetDriveBootImageActionType |
| Valeurs acceptées: | AddDriverToBootImage, RemoveDriverFromBootImage |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-WhatIf
Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.
| Type: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Entrées
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Sorties
System.Object