Partager via

Set-CMDriverPackage

  • Référence
Module:
ConfigurationManager

Modifier un package de pilotes.

Syntaxe

Set-CMDriverPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-DriverManufacturer <String>]
   [-DriverModel <String>]
   [-DriverPackageSource <String>]
   -InputObject <IResultObject>
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDriverPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-DriverManufacturer <String>]
   [-DriverModel <String>]
   [-DriverPackageSource <String>]
   -Id <String>
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDriverPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-DriverManufacturer <String>]
   [-DriverModel <String>]
   [-DriverPackageSource <String>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour modifier un package de pilotes.

Pour plus d’informations, consultez Gérer les pilotes dans Configuration Manager.

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 : Configurer le fabricant et le modèle d’un package de pilotes

Cette commande configure le fabricant et le modèle du package de pilotes avec l’ID XYZ00091.

Set-CMDriverPackage -PackageId "XYZ00091" -DriverManufacturer "Microsoft" -DriverModel "Surface 2"

Paramètres

-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

-CopyToPackageShareOnDistributionPoint

Les clients peuvent toujours télécharger un package de pilotes à partir d’un point de distribution. Si vous définissez ce paramètre sur $true, le site le rend disponible via un partage réseau nommé sur les points de distribution. Utilisez CustomPackageShareName pour spécifier un nom de partage personnalisé.

Lorsque vous activez cette option, plus d’espace est nécessaire sur les points de distribution. Elle s’applique à tous les points de distribution auxquels vous distribuez ce package de pilotes.

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

-CustomPackageShareName

Si vous activez CopyToPackageShareOnDistributionPoint, vous pouvez utiliser ce paramètre pour personnaliser le nom du partage. La longueur maximale est de 127 caractères et ne peut pas inclure les caractères suivants : " / [ ] : | < > + = ; , ? *. Vous pouvez spécifier un nom de partage et un nom de dossier, mais la valeur maximale de chacun est de 80 caractères. Par exemple : ShareName\FolderName.

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

-Description

Spécifiez une description facultative d’un package de pilotes pour vous aider à l’identifier.

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

-DisconnectUserFromDistributionPoint

Cette option est déconseillée. Il définit la propriété ForcedDisconnectEnabled du package de pilotes.

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

-DisconnectUserFromDistributionPointMins

Cette option est déconseillée. Elle définit la propriété ForcedDisconnectDelay du package de pilotes.

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

-DisconnectUserFromDistributionPointRetryCount

Cette option est déconseillée. Elle définit la propriété ForcedDisconnectNumRetries du package de pilotes.

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

-DistributionPointUpdateSchedule

Utilisez ce paramètre pour mettre à jour les points de distribution selon une planification. Pour obtenir un objet de planification, utilisez l’applet de commande New-CMSchedule .

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

-DriverManufacturer

Utilisez ce paramètre pour définir le fabricant de l’appareil. La taille maximale est de 100 caractères.

Utilisez-le avec le paramètre DriverModel . Vous pouvez les utiliser pour gérer le catalogue de pilotes et la pré-mise en cache des séquences de tâches. Pour plus d’informations, consultez Configurer le contenu de pré-mise en cache pour les séquences de tâches.

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

-DriverModel

Utilisez ce paramètre pour définir le modèle de l’appareil. La taille maximale est de 100 caractères.

Utilisez-le avec le paramètre DriverManufacturer . Vous pouvez les utiliser pour gérer le catalogue de pilotes et la pré-mise en cache des séquences de tâches. Pour plus d’informations, consultez Configurer le contenu de pré-mise en cache pour les séquences de tâches.

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

-DriverPackageSource

Spécifiez un chemin d’accès à l’emplacement réseau pour sourcer les fichiers de pilote.

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. Le fournisseur SMS doit disposer d’autorisations contrôle total sur cet emplacement.

Lorsque vous ajoutez des pilotes de périphérique à un package de pilotes, Configuration Manager les copie dans ce chemin d’accès. Vous pouvez ajouter à un package de pilotes uniquement les pilotes de périphérique que vous avez importés et qui sont activés dans le catalogue 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

-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écifiez l’ID d’un package de pilotes à configurer. Cette valeur est un ID de package standard, par exemple : XYZ00020.

Type:String
Alias:PackageId
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écifiez un objet de package de pilote à configurer. Pour obtenir cet objet, utilisez l’applet de commande Get-CMDriverPackage .

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

-MulticastAllow

Définissez ce paramètre sur $true pour permettre le transfert de ce package via la multidiffusion. Pour plus d’informations, consultez Utiliser la multidiffusion pour déployer Windows sur le réseau avec Configuration Manager.

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

-MulticastEncrypt

Si vous activez MulticastAllow, définissez ce paramètre sur $true pour chiffrer les packages de multidiffusion.

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

-MulticastTransferOnly

Si vous activez MulticastAllow, définissez ce paramètre sur $true pour transférer uniquement ce package de pilotes via la multidiffusion.

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

-Name

Spécifiez le nom d’un package de pilotes à configurer.

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écifiez un nouveau nom pour le 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

-PassThru

Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette applet de commande peut ne pas générer de 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

-PrestageBehavior

Spécifiez le comportement lorsque vous activez un point de distribution pour le contenu préparé :

  • ManualCopy: copiez manuellement le contenu de ce package sur le point de distribution
  • DownloadDelta: Télécharger uniquement les modifications de contenu sur le point de distribution
  • OnDemand: télécharger automatiquement le contenu lorsque des packages sont attribués à des points de distribution

Pour plus d’informations, consultez Utiliser du contenu préparé.

Type:PrestageBehavior
Valeurs acceptées:ManualCopy, DownloadDelta, OnDemand
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Priority

Spécifiez l’ordre dans lequel le site envoie le contenu à d’autres sites et les points de distribution de ce site.

Le site envoie du contenu de haute priorité avant les packages de priorité moyenne ou basse. Les packages avec une priorité égale sont envoyés dans l’ordre dans lequel ils sont créés.

Type:Priority
Valeurs acceptées:High, Medium, Low
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SendToPreferredDistributionPoint

Si vous souhaitez activer la distribution de contenu à la demande sur des points de distribution préférés, définissez ce paramètre sur $true. Lorsque vous activez ce paramètre, si un client demande le contenu pour le package et que le contenu n’est disponible sur aucun point de distribution, le point de gestion distribue le contenu. Pour plus d’informations, consultez Distribution de contenu à la demande.

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

-Version

Spécifiez la version du package de pilotes. Cette valeur est une chaîne que vous gérez.

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

-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