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\Driver
ré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\Driver
ré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- KeepExistingCategory
existantes : 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