Compartilhar via

Set-CMDriver

  • Referência
Módulo:
ConfigurationManager

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

Sintaxe

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

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Modificar um controlador

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 obtém um controlador de dispositivo com o nome cdrom.sys através do cmdlet Get-CMDriver . O comando armazena esse objeto na variável $Driver.

O segundo comando muda o nome do controlador e adiciona uma descrição. O comando especifica valores para os parâmetros EnableAndAllowInstall e RunOnAnyPlatform .

Exemplo 2: Modificar um controlador com o pipeline

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

Este comando obtém um controlador com o nome cdrom.sys e, em seguida, transmite-o para o cmdlet atual com o operador de pipeline. O cmdlet atual muda o nome do controlador 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 este cmdlet adiciona a um controlador. Para obter um objeto de categoria administrativa, utilize o cmdlet Get-CMCategory .

Tipo:IResultObject[]
Aliases:AddAdministrativeCategories
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AddBootImagePackage

Especifica uma matriz 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 .

Tipo:IResultObject[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AddDriverPackage

Especifica uma matriz de objetos de pacote de controlador. Utilize este parâmetro para especificar os pacotes de controladores que o Configuration Manager utiliza para distribuir os controladores de dispositivo. Para obter um objeto de pacote de controlador, utilize o cmdlet Get-CMDriverPackage .

Tipo:IResultObject[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AddSupportedPlatformName

{{ Fill AddSupportedPlatformName Description }}

Tipo:String[]
Aliases:AddSupportedPlatformNames
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AdministrativeCategory

Especifica uma matriz de categorias administrativas. Atribua os controladores de dispositivo a uma categoria administrativa para fins de filtragem, como as categorias Ambiente de Trabalho ou Blocos de Notas.

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

Tipo:IResultObject[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ClearAdministrativeCategory

Indica que este cmdlet remove todos os objetos de categoria administrativa do controlador.

Tipo:SwitchParameter
Aliases:ClearAdministrativeCategories
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ClearSupportedPlatformName

{{ Fill ClearSupportedPlatformName Description }}

Tipo:SwitchParameter
Aliases:ClearSupportedPlatformNames
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DriverSource

Especifica a localização da origem do pacote de controladores. Quando cria um pacote de controladores, a localização de origem do pacote tem de apontar para uma partilha de rede vazia que não seja utilizada por outro pacote de controlador.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableAndAllowInstall

Indica se o Configuration Manager ativa os controladores e permite que os computadores instalem os controladores.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifica o ID de um controlador de dispositivo.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

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

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifica o nome de um controlador de dispositivo.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NewName

Especifica um novo nome para o controlador de dispositivo.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PassThru

Devolve um objeto que representa o controlador. Por padrão, esse cmdlet não gera saída.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveAdministrativeCategory

Especifica uma matriz de objetos de categoria administrativa que este cmdlet remove de um controlador. Para obter um objeto de categoria administrativa, utilize Get-CMCategory.

Tipo:IResultObject[]
Aliases:RemoveAdministrativeCategories
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveBootImagePackage

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

Tipo:IResultObject[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveDriverPackage

Especifica uma matriz de objetos de pacote de controlador. Utilize este parâmetro para remover os pacotes de controladores que o Configuration Manager utiliza para distribuir os controladores de dispositivo. Para obter um objeto de pacote de controlador, utilize o cmdlet Get-CMDriverPackage .

Tipo:IResultObject[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveSupportedPlatformName

{{ Fill RemoveSupportedPlatformName Description }}

Tipo:String[]
Aliases:RemoveSupportedPlatformNames
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunOnAnyPlatform

Indica que o controlador de dispositivo pode ser executado em todas as plataformas.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SupportedPlatformName

Especifica uma matriz de nomes de plataformas nas quais o controlador de dispositivo pode ser executado.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UpdateBootImageDistributionPoint

Indica se o Configuration Manager atualiza as imagens de arranque nos respetivos pontos de distribuição para adicionar os novos controladores.

Tipo:Boolean
Aliases:UpdateDistributionPointsForBootImagePackage, UpdateBootImageDistributionPoints
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UpdateDriverDistributionPoint

Indica que o Configuration Manager atualiza os pontos de distribuição quando o controlador de dispositivo é adicionado ao pacote de controlador.

Tipo:Boolean
Aliases:UpdateDistributionPointsForDriverPackage, UpdateDriverDistributionPoints
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object