Import-CMDriver

  • Riferimento
Modulo:
ConfigurationManager

Importare un driver di dispositivo nel catalogo driver.

Sintassi

Import-CMDriver
      [-AdministrativeCategory <IResultObject[]>]
      [-AdministrativeCategoryName <String[]>]
      [-BootImagePackage <IResultObject[]>]
      [-DriverPackage <IResultObject[]>]
      [-EnableAndAllowInstall <Boolean>]
      [-ImportDuplicateDriverOption <ImportDuplicateDriverOption>]
      [-ImportFolder]
      -Path <String>
      [-SupportedPlatform <IResultObject[]>]
      [-SupportedPlatformName <String[]>]
      [-UpdateBootImageDistributionPoint <Boolean>]
      [-UpdateDriverPackageDistributionPoint <Boolean>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Il cmdlet Import-CMDriver importa uno o più driver di dispositivo nel catalogo driver in Configuration Manager. Quando si importano driver di dispositivo nel catalogo, è possibile aggiungere i driver di dispositivo ai pacchetti driver o ai pacchetti di immagini di avvio.

Nell'ambito del processo di importazione per il driver di dispositivo, Configuration Manager legge le informazioni seguenti associate al dispositivo:

  • Provider
  • Classe
  • Versione
  • Signature
  • Hardware supportato
  • Piattaforma supportata

Per impostazione predefinita, il driver prende il nome dal primo dispositivo hardware supportato. Per rinominare il driver di dispositivo, usare il parametro -NewName del cmdlet Set-CMDriver . L'elenco delle piattaforme supportate si basa sulle informazioni contenute nel file INF del driver. Poiché l'accuratezza di queste informazioni può variare, verificare manualmente che il driver di dispositivo sia supportato dopo l'importazione nel catalogo dei 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: Importare tutti i driver di dispositivo in un percorso

Questo comando importa tutti i driver di dispositivo che si trovano nel percorso \\Server1\Driverdi rete .

Import-CMDriver -Path "\\Server1\Driver" -ImportFolder

Esempio 2: Importare un driver di dispositivo per nome

Questo comando importa il driver denominato driver.inf dal percorso \\Server1\Driverdi rete .

Import-CMDriver -Path "\\Server1\Driver\driver.inf"

Parametri

-AdministrativeCategory

Specificare una matrice di oggetti categoria. Per ottenere questo oggetto, usare il cmdlet Get-CMCategory .

Assegnare i driver di dispositivo a una categoria a scopo di filtro, ad esempio Desktop o Notebook.

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

-AdministrativeCategoryName

Anziché ottenere e specificare un oggetto per una categoria con il parametro AdministrativeCategory , usare questo parametro per specificare semplicemente il nome di una categoria. È anche possibile usare una matrice di nomi di categoria.

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

-BootImagePackage

Specificare una matrice di oggetti immagine di avvio. Per ottenere questo oggetto, usare il cmdlet Get-CMBootImage .

Usare questo parametro per aggiungere i driver importati alle immagini di avvio specificate.

Aggiungere solo i driver necessari per l'avvio di Windows PE (WinPE):

  • Assicurarsi che i driver aggiunti all'immagine di avvio corrispondano all'architettura dell'immagine di avvio.

  • WinPE include già molti driver predefiniti. Aggiungere solo i driver di rete e di archiviazione non inclusi in WinPE.

  • Aggiungere solo i driver di rete e di archiviazione all'immagine di avvio, a meno che non siano previsti requisiti per altri driver in WinPE.

  • È consigliabile usare driver con una firma digitale valida.

Tipo:IResultObject[]
Alias:BootImagePackages
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

-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

-DriverPackage

Specificare una matrice di oggetti pacchetto driver. Per ottenere questo oggetto, usare il cmdlet Get-CMDriverPackage .

Usare questo parametro per aggiungere i driver importati ai pacchetti di driver specificati.

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

-EnableAndAllowInstall

Abilitare il driver e consentire ai client di installarlo durante il passaggio della sequenza di attività Applica automaticamente driver .

I driver aggiunti al pacchetto driver non sono interessati.

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

-ImportDuplicateDriverOption

Specificare il modo in cui Configuration Manager gestisce i driver di dispositivo duplicati.

  • AppendCategory: importare il driver e aggiungere una nuova categoria alle categorie - KeepExistingCategoryesistenti: importare il driver e mantenere le categorie esistenti
  • NotImport: non importare il driver
  • OverwriteCategory: importare il driver e sovrascrivere le categorie esistenti
Tipo:ImportDuplicateDriverOption
Valori accettati:NotImport, AppendCategory, KeepExistingCategory, OverwriteCategory
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ImportFolder

Aggiungere questo parametro per importare tutti i driver di dispositivo nella cartella di destinazione.

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

-Path

Specificare un percorso per i file del driver da importare.

Tipo:String
Alias:FileName, FilePath, ImportFilePath, Location, UncFileLocation
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SupportedPlatform

Specificare un oggetto piattaforma supportato a cui il driver di dispositivo è applicabile e può essere eseguito. Per ottenere questo oggetto, usare il cmdlet Get-CMSupportedPlatform .

Tipo:IResultObject[]
Alias:SupportedPlatforms
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 supportate in cui è possibile eseguire il driver di dispositivo. Ad esempio, "All Windows 10 (64-bit)".

Tipo:String[]
Alias:SupportedPlatformNames
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

-UpdateDriverPackageDistributionPoint

Se si usa il parametro -DriverPackage , impostare questo parametro $true su per aggiornare il pacchetto driver nei punti di distribuzione assegnati.

Tipo:Boolean
Alias:UpdateDistributionPointsforDriverPackage
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

None

Output

IResultObject