Set-CMDriverBootImage
Adiciona um driver a uma imagem de inicialização ou remove um driver de uma imagem de inicialização.
Syntax
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
O cmdlet Set-CMDriverBootImage adiciona um driver a uma imagem de inicialização ou remove um driver de uma imagem de inicialização. Você pode adicionar drivers de dispositivo Windows importados para o catálogo de driver Configuration Manager a uma ou mais imagens de inicialização. Você deve adicionar apenas drivers de dispositivo de armazenamento em massa e drivers de dispositivo de adaptador de rede para inicializar imagens porque outros tipos de drivers não são necessários e aumentarão o tamanho da imagem de inicialização.
Observação
Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>
. Para obter mais informações, confira introdução.
Exemplos
Exemplo 1: Adicionar um driver a uma imagem de inicialização
PS XYZ:\> Set-CMDriverBootImage -SetDriveBootImageAction AddDriverToBootImage -DriverName "Adaptec Embedded SCSI HostRAID Controller" -BootImageName "Boot image (x64)"
Este comando adiciona o driver chamado Adaptec Embedded SCSI HostRAID Controller à imagem de inicialização chamada Imagem de inicialização (x64).
Exemplo 2: remover um driver de uma imagem de inicialização
PS XYZ:\> Set-CMDriverBootImage -SetDriveBootImageAction RemoveDriverFromBootImage -DriverName "Adaptec SCSI HostRAID Management Processor Device" -BootImageName "Boot image (x64)"
Esse comando remove o driver chamado Adaptec SCSI HostRAID Management Processor Device da imagem de inicialização chamada Imagem de inicialização (x64).
Parâmetros
-BootImage
Especifica um objeto CMBootImage . Para obter um objeto CMBootImage , use o cmdlet Get-CMBootImage .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BootImageId
Especifica a ID de uma imagem de inicialização.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BootImageName
Especifica o nome de uma imagem de inicialização.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Driver
Especifica um objeto driver. Para obter um objeto CMDriver , use o cmdlet Get-CMDriver .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DriverId
Especifica a ID de um driver.
Type: | Int32 |
Aliases: | Id, CIId, CI_ID |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DriverName
Especifica o nome de um driver.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SetDriveBootImageAction
Especifica a ação de imagem de inicialização. Os valores aceitáveis para esse parâmetro são:
- AddDriverToBootImage
- RemoveDriverFromBootImage
Type: | SetDriveBootImageActionType |
Accepted values: | AddDriverToBootImage, RemoveDriverFromBootImage |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
System.Object
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de