Set-CMDriver
Altera as configurações de um driver de dispositivo.
Syntax
Set-CMDriver
[-AddAdministrativeCategory <IResultObject[]>]
[-AddBootImagePackage <IResultObject[]>]
[-AddDriverPackage <IResultObject[]>]
[-AddSupportedPlatformName <String[]>]
[-AdministrativeCategory <IResultObject[]>]
[-ClearAdministrativeCategory]
[-ClearSupportedPlatformName]
[-Description <String>]
[-DriverSource <String>]
[-EnableAndAllowInstall <Boolean>]
-InputObject <IResultObject>
[-NewName <String>]
[-PassThru]
[-RemoveAdministrativeCategory <IResultObject[]>]
[-RemoveBootImagePackage <IResultObject[]>]
[-RemoveDriverPackage <IResultObject[]>]
[-RemoveSupportedPlatformName <String[]>]
[-RunOnAnyPlatform]
[-SupportedPlatformName <String[]>]
[-UpdateBootImageDistributionPoint <Boolean>]
[-UpdateDriverDistributionPoint <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-CMDriver
[-AddAdministrativeCategory <IResultObject[]>]
[-AddBootImagePackage <IResultObject[]>]
[-AddDriverPackage <IResultObject[]>]
[-AddSupportedPlatformName <String[]>]
[-AdministrativeCategory <IResultObject[]>]
[-ClearAdministrativeCategory]
[-ClearSupportedPlatformName]
[-Description <String>]
[-DriverSource <String>]
[-EnableAndAllowInstall <Boolean>]
-Id <String>
[-NewName <String>]
[-PassThru]
[-RemoveAdministrativeCategory <IResultObject[]>]
[-RemoveBootImagePackage <IResultObject[]>]
[-RemoveDriverPackage <IResultObject[]>]
[-RemoveSupportedPlatformName <String[]>]
[-RunOnAnyPlatform]
[-SupportedPlatformName <String[]>]
[-UpdateBootImageDistributionPoint <Boolean>]
[-UpdateDriverDistributionPoint <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-CMDriver
[-AddAdministrativeCategory <IResultObject[]>]
[-AddBootImagePackage <IResultObject[]>]
[-AddDriverPackage <IResultObject[]>]
[-AddSupportedPlatformName <String[]>]
[-AdministrativeCategory <IResultObject[]>]
[-ClearAdministrativeCategory]
[-ClearSupportedPlatformName]
[-Description <String>]
[-DriverSource <String>]
[-EnableAndAllowInstall <Boolean>]
-Name <String>
[-NewName <String>]
[-PassThru]
[-RemoveAdministrativeCategory <IResultObject[]>]
[-RemoveBootImagePackage <IResultObject[]>]
[-RemoveDriverPackage <IResultObject[]>]
[-RemoveSupportedPlatformName <String[]>]
[-RunOnAnyPlatform]
[-SupportedPlatformName <String[]>]
[-UpdateBootImageDistributionPoint <Boolean>]
[-UpdateDriverDistributionPoint <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
O cmdlet Set-CMDriver altera as configurações de um driver de dispositivo no catálogo do driver.
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: modificar um driver
PS XYZ:\> $Driver = Get-CMDriver -Name "cdrom.sys"
PS XYZ:\> Set-CMDriver -InputObject $Driver -NewName "testDriver" -Description "Test configuration" -EnableAndAllowInstall $True -RunOnAnyPlatform $TrueO primeiro comando obtém um driver de dispositivo chamado cdrom.sys usando o cmdlet Get-CMDriver . O comando armazena esse objeto na variável $Driver.
O segundo comando renomeia o driver e adiciona uma descrição. O comando especifica valores para os parâmetros EnableAndAllowInstall e RunOnAnyPlatform .
Exemplo 2: modificar um driver usando o pipeline
PS XYZ:\> Get-CMDriver -Name "cdrom.sys" | Set-CMDriver -NewName testDriver -Description description -EnableAndAllowInstall $True -RunOnAnyPlatform $TrueEsse comando obtém um driver chamado cdrom.sys e, em seguida, passa-o para o cmdlet atual usando o operador de pipeline. O cmdlet atual renomeia o driver e adiciona uma descrição. O comando especifica valores para EnableAndAllowInstall e RunOnAnyPlatform.
Parâmetros
-AddAdministrativeCategory
Especifica uma matriz de objetos de categoria administrativa que esse cmdlet adiciona a um driver. Para obter um objeto de categoria administrativa, use o cmdlet Get-CMCategory .
| Type: | IResultObject[] |
| Aliases: | AddAdministrativeCategories |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AddBootImagePackage
Especifica uma matriz de objetos de imagem de inicialização. Use esse parâmetro para especificar as imagens de inicialização que podem instalar os drivers de dispositivo. Para obter um objeto de imagem de inicialização, use o cmdlet Get-CMBootImage .
| Type: | IResultObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AddDriverPackage
Especifica uma matriz de objetos de pacote de driver. Use esse parâmetro para especificar os pacotes de driver que Configuration Manager usa para distribuir os drivers de dispositivo. Para obter um objeto de pacote de driver, use o cmdlet Get-CMDriverPackage .
| Type: | IResultObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AddSupportedPlatformName
{{ Preenchimento AddSupportedPlatformName Description }}
| Type: | String[] |
| Aliases: | AddSupportedPlatformNames |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AdministrativeCategory
Especifica uma matriz de categorias administrativas. Atribua os drivers de dispositivo a uma categoria administrativa para fins de filtragem, como Categorias de Desktops ou Notebooks.
Para obter um objeto de categoria administrativa, use o cmdlet Get-CMCategory .
| Type: | IResultObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClearAdministrativeCategory
Indica que esse cmdlet remove todos os objetos de categoria administrativa do driver.
| Type: | SwitchParameter |
| Aliases: | ClearAdministrativeCategories |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClearSupportedPlatformName
{{ Preencher ClearSupportedPlatformName Description }}
| Type: | SwitchParameter |
| Aliases: | ClearSupportedPlatformNames |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
-Description
Especifica uma descrição para o driver do dispositivo.
| Type: | String |
| Position: | Named |
| Default value: | None |
| 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 |
-DriverSource
Especifica o local de origem do pacote do driver. Quando você cria um pacote de driver, o local de origem do pacote deve apontar para um compartilhamento de rede vazio que não é usado por outro pacote de driver.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableAndAllowInstall
Indica se Configuration Manager habilita os drivers e permite que os computadores instalem os drivers.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
-Id
Especifica a ID de um driver de dispositivo.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Especifica um objeto driver. Para obter um objeto driver, use o cmdlet Get-CMDriver .
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Especifica o nome de um driver de dispositivo.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewName
Especifica um novo nome para o driver do dispositivo.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Retorna um objeto que representa o driver. Por padrão, esse cmdlet não gera saída.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveAdministrativeCategory
Especifica uma matriz de objetos de categoria administrativa que este cmdlet remove de um driver. Para obter um objeto de categoria administrativa, use Get-CMCategory.
| Type: | IResultObject[] |
| Aliases: | RemoveAdministrativeCategories |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveBootImagePackage
Especifica uma matriz de objetos de imagem de inicialização. Use esse parâmetro para remover as imagens de inicialização que podem instalar o driver do dispositivo. Para obter um objeto de imagem de inicialização, use o cmdlet Get-CMBootImage .
| Type: | IResultObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveDriverPackage
Especifica uma matriz de objetos de pacote de driver. Use esse parâmetro para remover os pacotes de driver que Configuration Manager usa para distribuir os drivers de dispositivo. Para obter um objeto de pacote de driver, use o cmdlet Get-CMDriverPackage .
| Type: | IResultObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveSupportedPlatformName
{{ Preenchimento RemoveSupportedPlatformName Description }}
| Type: | String[] |
| Aliases: | RemoveSupportedPlatformNames |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunOnAnyPlatform
Indica que o driver do dispositivo pode ser executado em todas as plataformas.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SupportedPlatformName
Especifica uma matriz de nomes de plataformas nas quais o driver de dispositivo pode ser executado.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpdateBootImageDistributionPoint
Indica se Configuration Manager atualiza imagens de inicialização em seus pontos de distribuição para adicionar os novos drivers.
| Type: | Boolean |
| Aliases: | UpdateDistributionPointsForBootImagePackage, UpdateBootImageDistributionPoints |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpdateDriverDistributionPoint
Indica que Configuration Manager atualiza os pontos de distribuição quando o driver do dispositivo é adicionado ao pacote de driver.
| Type: | Boolean |
| Aliases: | UpdateDistributionPointsForDriverPackage, UpdateDriverDistributionPoints |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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
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, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de