Set-CMDriver

Module:

ConfigurationManager

Modifie les paramètres d’un pilote de périphérique.

Syntaxe

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

L’applet de commande Set-CMDriver modifie les paramètres d’un pilote de périphérique 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 : Modifier un pilote

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

La première commande obtient un pilote de périphérique nommé cdrom.sys à l’aide de l’applet de commande Get-CMDriver . La commande stocke cet objet dans la variable $Driver.

La deuxième commande renomme le pilote et ajoute une description. La commande spécifie des valeurs pour les paramètres EnableAndAllowInstall et RunOnAnyPlatform .

Exemple 2 : Modifier un pilote à l’aide du pipeline

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

Cette commande obtient un pilote nommé cdrom.sys, puis le transmet à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. L’applet de commande actuelle renomme le pilote et ajoute une description. La commande spécifie des valeurs pour EnableAndAllowInstall et RunOnAnyPlatform.

Paramètres

-AddAdministrativeCategory

Spécifie un tableau d’objets de catégorie d’administration que cette applet de commande ajoute à un pilote. Pour obtenir un objet de catégorie d’administration, utilisez l’applet de commande Get-CMCategory .

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

-AddBootImagePackage

Spécifie un tableau d’objets image de démarrage. Utilisez ce paramètre pour spécifier les images de démarrage qui peuvent installer les pilotes de périphérique. Pour obtenir un objet image de démarrage, utilisez l’applet de commande Get-CMBootImage .

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

-AddDriverPackage

Spécifie un tableau d’objets de package de pilotes. Utilisez ce paramètre pour spécifier les packages de pilotes que Configuration Manager utilise pour distribuer les pilotes de périphérique. Pour obtenir un objet de package de pilote, utilisez l’applet de commande Get-CMDriverPackage .

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

-AddSupportedPlatformName

{{ Fill AddSupportedPlatformName Description }}

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

-AdministrativeCategory

Spécifie un tableau de catégories administratives. Affectez les pilotes de périphérique à une catégorie administrative à des fins de filtrage, telles que les catégories Ordinateurs de bureau ou Notebooks.

Pour obtenir un objet de catégorie d’administration, utilisez l’applet de commande Get-CMCategory .

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

-ClearAdministrativeCategory

Indique que cette applet de commande supprime tous les objets de catégorie d’administration du pilote.

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

-ClearSupportedPlatformName

{{ Fill ClearSupportedPlatformName Description }}

Type:	SwitchParameter
Alias:	ClearSupportedPlatformNames
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

-Description

Spécifie une description pour le pilote de périphérique.

Type:	String
Position:	Named
Valeur par défaut:	None
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

-DriverSource

Spécifie l’emplacement source du package de pilotes. Lorsque vous créez un package de pilotes, l’emplacement source du package doit pointer vers un partage réseau vide qui n’est pas utilisé par un autre package de pilotes.

Type:	String
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

Indique si Configuration Manager active les pilotes et autorise les ordinateurs à installer les pilotes.

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

-Id

Spécifie l’ID d’un pilote de périphérique.

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

-InputObject

Spécifie un objet pilote. Pour obtenir un objet pilote, utilisez l’applet de commande Get-CMDriver .

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

-Name

Spécifie le nom d’un pilote de périphérique.

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

-NewName

Spécifie un nouveau nom pour le pilote de périphérique.

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

-PassThru

Renvoie un objet qui représente le pilote. Par défaut, cette applet de commande ne génère aucune sortie.

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

-RemoveAdministrativeCategory

Spécifie un tableau d’objets de catégorie d’administration que cette applet de commande supprime d’un pilote. Pour obtenir un objet de catégorie d’administration, utilisez Get-CMCategory.

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

-RemoveBootImagePackage

Spécifie un tableau d’objets image de démarrage. Utilisez ce paramètre pour supprimer les images de démarrage qui peuvent installer le pilote de périphérique. Pour obtenir un objet image de démarrage, utilisez l’applet de commande Get-CMBootImage .

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

-RemoveDriverPackage

Spécifie un tableau d’objets de package de pilotes. Utilisez ce paramètre pour supprimer les packages de pilotes utilisés par Configuration Manager pour distribuer les pilotes de périphérique. Pour obtenir un objet de package de pilote, utilisez l’applet de commande Get-CMDriverPackage .

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

-RemoveSupportedPlatformName

{{ Fill RemoveSupportedPlatformName Description }}

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

-RunOnAnyPlatform

Indique que le pilote de périphérique peut s’exécuter sur toutes les plateformes.

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

-SupportedPlatformName

Spécifie un tableau de noms de plateformes sur lesquelles le pilote de périphérique peut s’exécuter.

Type:	String[]
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

-UpdateDriverDistributionPoint

Indique que Configuration Manager met à jour les points de distribution lorsque le pilote de périphérique est ajouté au package de pilotes.

Type:	Boolean
Alias:	UpdateDistributionPointsForDriverPackage, UpdateDriverDistributionPoints
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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object

Liens associés

• Disable-CMDriver
• Enable-CMDriver
• Get-CMDriver
• Import-CMDriver
• Remove-CMDriver
• Get-CMCategory
• Get-CMBootImage
• Get-CMDriverPackage