Partilhar via


Set-CMDriver

SYNOPSIS

Altera as definições de um controlador do dispositivo.

SYNTAX

SetDriverByResultObject (Padrão)

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

SetDriverById

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

SetDriverByName

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 definições de um controlador de dispositivo no catálogo do controlador.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

Exemplo 1: Modificar um condutor

PS XYZ:\> $Driver = Get-CMDriver -Name "cdrom.sys"
PS XYZ:\> Set-CMDriver -InputObject $Driver -NewName "testDriver" -Description "Test configuration" -EnableAndAllowInstall $True -RunOnAnyPlatform $True

O primeiro comando recebe um controlador de dispositivo chamado cdrom.sys utilizando o cmdlet Get-CMDriver. O comando armazena que se oponha na variável $Driver.

O segundo comando renomea o condutor e adiciona uma descrição. O comando especifica valores para os parâmetros EnableAndAllowInstall e RunOnAnyPlatform.

Exemplo 2: Modificar um condutor utilizando o gasoduto

PS XYZ:\> Get-CMDriver -Name "cdrom.sys" | Set-CMDriver -NewName testDriver -Description description -EnableAndAllowInstall $True -RunOnAnyPlatform $True

Este comando recebe um controlador chamado cdrom.sys e, em seguida, passa-o para o cmdlet atual usando o operador do gasoduto. O cmdlet atual renomea o condutor e adiciona uma descrição. O comando especifica valores para EnableAndAllowInstall e RunOnAnyPlatform.

PARAMETERS

-AdministrativeCategoria

Especifica um conjunto de objetos de categoria administrativa que este cmdlet adiciona a um condutor. Para obter um objeto de categoria administrativa, utilize o cmdlet Get-CMCategory.

Type: IResultObject[]
Parameter Sets: (All)
Aliases: AddAdministrativeCategories

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

-AddBootImagePackage

Especifica uma variedade de objetos de imagem de arranque. Utilize este parâmetro para especificar as imagens de arranque que podem instalar os controladores do dispositivo. Para obter um objeto de imagem de arranque, utilize o cmdlet Get-CMBootImage.

Type: IResultObject[]
Parameter Sets: (All)
Aliases:

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

-AddDriverPackage

Especifica uma série de objetos de pacote do controlador. Utilize este parâmetro para especificar as embalagens do controlador que o Gestor de Configuração utiliza para distribuir os controladores do dispositivo. Para obter um objeto de pacote de controlador, utilize o cmdlet Get-CMDriverPackage.

Type: IResultObject[]
Parameter Sets: (All)
Aliases:

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

-AddSupportedPlatformName

{{ Preencha AddSupportedPlatformName Descrição do nome }}

Type: String[]
Parameter Sets: (All)
Aliases: AddSupportedPlatformNames

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

-Divisão Administrativa

Especifica um conjunto de categorias administrativas. Atribua os controladores do dispositivo a uma categoria administrativa para fins de filtragem, tais como categorias de Desktops ou Notebooks.

Para obter um objeto de categoria administrativa, utilize o cmdlet Get-CMCategory.

Type: IResultObject[]
Parameter Sets: (All)
Aliases:

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

-ClearAdministrativeCategoria

Indica que este cmdlet remove todos os objetos da categoria administrativa do condutor.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: ClearAdministrativeCategories

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

-ClearSupportedPlatformName

{{ Preencha ClearSupportedPlatformName Descrição do nome }}

Type: SwitchParameter
Parameter Sets: (All)
Aliases: ClearSupportedPlatformNames

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

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-Descrição

Especifica uma descrição para o controlador do dispositivo.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-DriverSource

Especifica a localização da fonte do pacote do condutor. Quando criar um pacote de condutor, a localização de origem da embalagem deve indicar uma partilha de rede vazia que não seja utilizada por outro pacote do condutor.

Type: String
Parameter Sets: (All)
Aliases:

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

-AtivarAndAllowInstall

Indica se o Gestor de Configuração permite que os controladores e permita que os computadores instalem os controladores.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

- ID

Especifica a identificação de um controlador de dispositivo.

Type: String
Parameter Sets: SetDriverById
Aliases:

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

-InputObject

Especifica um objeto de condutor. Para obter um objeto de controlador, utilize o cmdlet Get-CMDriver.

Type: IResultObject
Parameter Sets: SetDriverByResultObject
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Name

Especifica o nome de um controlador de dispositivo.

Type: String
Parameter Sets: SetDriverByName
Aliases:

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

-Novo Nome

Especifica um novo nome para o controlador do dispositivo.

Type: String
Parameter Sets: (All)
Aliases:

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

- PassThru

Devolve um objeto que representa o condutor. Por predefinição, este cmdlet não gera quaisquer dados.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Remover a Categorização Administrativa

Especifica um conjunto de objetos de categoria administrativa que este cmdlet remove de um condutor. Para obter um objeto de categoria administrativa, utilize a Get-CMCategoria.

Type: IResultObject[]
Parameter Sets: (All)
Aliases: RemoveAdministrativeCategories

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

-RemoveBootImagePackage

Especifica uma variedade de objetos de imagem de arranque. Utilize este parâmetro para remover as imagens de arranque que podem instalar o controlador do dispositivo. Para obter um objeto de imagem de arranque, utilize o cmdlet Get-CMBootImage.

Type: IResultObject[]
Parameter Sets: (All)
Aliases:

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

-RemoveDriverPackage

Especifica uma série de objetos de pacote do controlador. Utilize este parâmetro para remover as embalagens do controlador que o Gestor de Configuração utiliza para distribuir os controladores do dispositivo. Para obter um objeto de pacote de controlador, utilize o cmdlet Get-CMDriverPackage.

Type: IResultObject[]
Parameter Sets: (All)
Aliases:

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

-RemoverSupportedPlatformName

{{ Preencha RemoveSupportedPlatformName Descrição do nome }}

Type: String[]
Parameter Sets: (All)
Aliases: RemoveSupportedPlatformNames

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

-RunOnAnyPlatform

Indica que o controlador do dispositivo pode funcionar em todas as plataformas.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Nome de Mente Apoiada

Especifica uma série de nomes de plataformas nas quais o controlador do dispositivo pode funcionar.

Type: String[]
Parameter Sets: (All)
Aliases:

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

-UpdateBootImageDistributionPoint

Indica se o Gestor de Configuração atualiza as imagens de arranque nos seus pontos de distribuição para adicionar os novos controladores.

Type: Boolean
Parameter Sets: (All)
Aliases: UpdateDistributionPointsForBootImagePackage, UpdateBootImageDistributionPoints

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

-UpdateDriverDistributionPoint

Indica que o Gestor de Configuração atualiza os pontos de distribuição quando o controlador do dispositivo é adicionado ao pacote do controlador.

Type: Boolean
Parameter Sets: (All)
Aliases: UpdateDistributionPointsForDriverPackage, UpdateDriverDistributionPoints

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

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

Sistema.Objeto

NOTAS

Desativador-CMDriver

Ativar-CMDriver

Get-CMDriver

Importador-CMDriver

Remover-CMDriver

Get-CMCategoria

Get-CMBootImage

Get-CMDriverPackage