Condividi tramite

Set-CMDriver

  • Riferimento
Modulo:
ConfigurationManager

Modifica le impostazioni di un driver di dispositivo.

Sintassi

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

Descrizione

Il cmdlet Set-CMDriver modifica le impostazioni di un driver di dispositivo nel catalogo driver.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Modificare un driver

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

Il primo comando ottiene un driver di dispositivo denominato cdrom.sys usando il cmdlet Get-CMDriver . Il comando archivia l'oggetto nella variabile $Driver.

Il secondo comando rinomina il driver e aggiunge una descrizione. Il comando specifica i valori per i parametri EnableAndAllowInstall e RunOnAnyPlatform .

Esempio 2: Modificare un driver usando la pipeline

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

Questo comando ottiene un driver denominato cdrom.sys e quindi lo passa al cmdlet corrente usando l'operatore della pipeline. Il cmdlet corrente rinomina il driver e aggiunge una descrizione. Il comando specifica i valori per EnableAndAllowInstall e RunOnAnyPlatform.

Parametri

-AddAdministrativeCategory

Specifica una matrice di oggetti categoria amministrativa che questo cmdlet aggiunge a un driver. Per ottenere un oggetto categoria amministrativa, usare il cmdlet Get-CMCategory .

Tipo:IResultObject[]
Alias:AddAdministrativeCategories
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AddBootImagePackage

Specifica una matrice di oggetti immagine di avvio. Usare questo parametro per specificare le immagini di avvio che possono installare i driver di dispositivo. Per ottenere un oggetto immagine di avvio, usare il cmdlet Get-CMBootImage .

Tipo:IResultObject[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AddDriverPackage

Specifica una matrice di oggetti pacchetto driver. Usare questo parametro per specificare i pacchetti driver usati da Configuration Manager per distribuire i driver di dispositivo. Per ottenere un oggetto pacchetto driver, usare il cmdlet Get-CMDriverPackage .

Tipo:IResultObject[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AddSupportedPlatformName

{{ Fill AddSupportedPlatformName Description }}

Tipo:String[]
Alias:AddSupportedPlatformNames
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AdministrativeCategory

Specifica una matrice di categorie amministrative. Assegnare i driver di dispositivo a una categoria amministrativa a scopo di filtro, ad esempio le categorie Desktop o Notebook.

Per ottenere un oggetto categoria amministrativa, usare il cmdlet Get-CMCategory .

Tipo:IResultObject[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ClearAdministrativeCategory

Indica che questo cmdlet rimuove tutti gli oggetti categoria amministrativa dal driver.

Tipo:SwitchParameter
Alias:ClearAdministrativeCategories
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ClearSupportedPlatformName

{{ Fill ClearSupportedPlatformName Description }}

Tipo:SwitchParameter
Alias:ClearSupportedPlatformNames
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specifica una descrizione per il driver di dispositivo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DriverSource

Specifica il percorso di origine del pacchetto driver. Quando si crea un pacchetto driver, il percorso di origine del pacchetto deve puntare a una condivisione di rete vuota che non viene usata da un altro pacchetto driver.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableAndAllowInstall

Indica se Configuration Manager abilita i driver e consente ai computer di installare i driver.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Specifica l'ID di un driver di dispositivo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specifica un oggetto driver. Per ottenere un oggetto driver, usare il cmdlet Get-CMDriver .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica il nome di un driver di dispositivo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NewName

Specifica un nuovo nome per il driver di dispositivo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Restituisce un oggetto che rappresenta il driver. Per impostazione predefinita, il cmdlet non genera alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveAdministrativeCategory

Specifica una matrice di oggetti categoria amministrativa che questo cmdlet rimuove da un driver. Per ottenere un oggetto categoria amministrativa, usare Get-CMCategory.

Tipo:IResultObject[]
Alias:RemoveAdministrativeCategories
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveBootImagePackage

Specifica una matrice di oggetti immagine di avvio. Usare questo parametro per rimuovere le immagini di avvio che possono installare il driver di dispositivo. Per ottenere un oggetto immagine di avvio, usare il cmdlet Get-CMBootImage .

Tipo:IResultObject[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveDriverPackage

Specifica una matrice di oggetti pacchetto driver. Usare questo parametro per rimuovere i pacchetti driver usati da Configuration Manager per distribuire i driver di dispositivo. Per ottenere un oggetto pacchetto driver, usare il cmdlet Get-CMDriverPackage .

Tipo:IResultObject[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveSupportedPlatformName

{{ Fill RemoveSupportedPlatformName Description }}

Tipo:String[]
Alias:RemoveSupportedPlatformNames
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RunOnAnyPlatform

Indica che il driver di dispositivo può essere eseguito su tutte le piattaforme.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SupportedPlatformName

Specifica una matrice di nomi di piattaforme in cui è possibile eseguire il driver di dispositivo.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UpdateBootImageDistributionPoint

Indica se Configuration Manager aggiorna le immagini di avvio nei punti di distribuzione per aggiungere i nuovi driver.

Tipo:Boolean
Alias:UpdateDistributionPointsForBootImagePackage, UpdateBootImageDistributionPoints
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UpdateDriverDistributionPoint

Indica che Configuration Manager aggiorna i punti di distribuzione quando il driver di dispositivo viene aggiunto al pacchetto driver.

Tipo:Boolean
Alias:UpdateDistributionPointsForDriverPackage, UpdateDriverDistributionPoints
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object