Partager via


Import-CMDriver

Importez un pilote de périphérique dans le catalogue de pilotes.

Syntaxe

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

Description

L’applet de commande Import-CMDriver importe un ou plusieurs pilotes de périphérique dans le catalogue de pilotes dans Configuration Manager. Lorsque vous importez des pilotes de périphérique dans le catalogue, vous pouvez ajouter les pilotes de périphérique aux packages de pilotes ou aux packages d’images de démarrage.

Dans le cadre du processus d’importation du pilote de périphérique, Configuration Manager lit les informations suivantes associées à l’appareil :

  • Fournisseur
  • Classe
  • Version
  • Signature
  • Matériel pris en charge
  • Plateforme prise en charge

Par défaut, le pilote est nommé d’après le premier périphérique matériel qu’il prend en charge. Pour renommer le pilote de périphérique, utilisez le paramètre -NewName de l’applet de commande Set-CMDriver . La liste des plateformes prises en charge est basée sur les informations contenues dans le fichier INF du pilote. Étant donné que la précision de ces informations peut varier, vérifiez manuellement que le pilote de périphérique est pris en charge après l’avoir importé dans le catalogue de pilotes.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Importer tous les pilotes de périphérique dans un chemin d’accès

Cette commande importe tous les pilotes de périphérique situés dans le chemin d’accès \\Server1\Driverréseau .

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

Exemple 2 : Importer un pilote de périphérique par son nom

Cette commande importe le pilote nommé driver.inf à partir du chemin d’accès \\Server1\Driverréseau .

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

Paramètres

-AdministrativeCategory

Spécifiez un tableau d’objets de catégorie. Pour obtenir cet objet, utilisez l’applet de commande Get-CMCategory .

Affectez les pilotes de périphérique à une catégorie à des fins de filtrage, telles que les ordinateurs de bureau ou les notebooks.

Type:IResultObject[]
Alias:AdministrativeCategories
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AdministrativeCategoryName

Au lieu d’obtenir et de spécifier un objet pour une catégorie avec le paramètre AdministrativeCategory , utilisez ce paramètre pour spécifier simplement le nom d’une catégorie. Vous pouvez également utiliser un tableau de noms de catégorie.

Type:String[]
Alias:AdministrativeCategoryNames
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-BootImagePackage

Spécifiez un tableau d’objets image de démarrage. Pour obtenir cet objet, utilisez l’applet de commande Get-CMBootImage .

Utilisez ce paramètre pour ajouter les pilotes importés aux images de démarrage spécifiées.

Ajoutez uniquement les pilotes dont Windows PE (WinPE) a besoin pour démarrer :

  • Assurez-vous que les pilotes que vous ajoutez à l’image de démarrage correspondent à l’architecture de l’image de démarrage.

  • WinPE est déjà fourni avec de nombreux pilotes intégrés. Ajoutez uniquement les pilotes réseau et de stockage qui ne sont pas inclus dans WinPE.

  • Ajoutez uniquement des pilotes réseau et de stockage à l’image de démarrage, sauf s’il existe des exigences pour d’autres pilotes dans WinPE.

  • Il est préférable d’utiliser des pilotes qui ont une signature numérique valide.

Type:IResultObject[]
Alias:BootImagePackages
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DriverPackage

Spécifiez un tableau d’objets de package de pilotes. Pour obtenir cet objet, utilisez l’applet de commande Get-CMDriverPackage .

Utilisez ce paramètre pour ajouter les pilotes importés aux packages de pilotes spécifiés.

Type:IResultObject[]
Alias:DriverPackages
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableAndAllowInstall

Activez le pilote et autorisez les clients à l’installer pendant l’étape de séquence de tâches Appliquer automatiquement le pilote .

Les pilotes ajoutés au package de pilotes ne sont pas affectés.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ImportDuplicateDriverOption

Spécifiez la façon dont Configuration Manager gère les pilotes de périphérique en double.

  • AppendCategory: Importez le pilote et ajoutez une nouvelle catégorie aux catégories - KeepExistingCategoryexistantes : importez le pilote et conservez les catégories existantes
  • NotImport: n’importez pas le pilote
  • OverwriteCategory: importer le pilote et remplacer les catégories existantes
Type:ImportDuplicateDriverOption
Valeurs acceptées:NotImport, AppendCategory, KeepExistingCategory, OverwriteCategory
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ImportFolder

Ajoutez ce paramètre pour importer tous les pilotes de périphérique dans le dossier cible.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Path

Spécifiez un chemin d’accès aux fichiers de pilote à importer.

Type:String
Alias:FileName, FilePath, ImportFilePath, Location, UncFileLocation
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SupportedPlatform

Spécifiez un objet de plateforme pris en charge auquel le pilote de périphérique s’applique et peut s’exécuter. Pour obtenir cet objet, utilisez l’applet de commande Get-CMSupportedPlatform .

Type:IResultObject[]
Alias:SupportedPlatforms
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SupportedPlatformName

Spécifie un tableau de noms de plateformes prises en charge sur lequel le pilote de périphérique peut s’exécuter. Par exemple : "All Windows 10 (64-bit)".

Type:String[]
Alias:SupportedPlatformNames
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UpdateBootImageDistributionPoint

Indique si Configuration Manager met à jour les images de démarrage sur leurs points de distribution pour ajouter les nouveaux pilotes.

Type:Boolean
Alias:UpdateDistributionPointsForBootImagePackage, UpdateBootImageDistributionPoints
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UpdateDriverPackageDistributionPoint

Si vous utilisez le paramètre -DriverPackage , définissez ce paramètre $true sur pour mettre à jour le package de pilotes sur les points de distribution attribués.

Type:Boolean
Alias:UpdateDistributionPointsforDriverPackage
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

IResultObject