Partager via

Set-CMDriverPackage

  • Référence
Module:
ConfigurationManager

Modifier un package de pilotes.

Syntax

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 cmdlet pour modifier un package de pilotes.

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

Notes

Exécutez les cmdlets Configuration Manager à partir du lecteur de site Configuration Manager, par PS XYZ:\> exemple. Pour plus d’informations, voir la mise en place.

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

- Confirmer

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

- WhatIf

Présente ce qui se produit si le cmdlet s’exécute. La cmdlet ne s’exécute pas.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters: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, davantage d’espace est requis sur les points de distribution. Elle s’applique à tous les points de distribution vers lesquels vous distribuez ce package de pilotes.

Type:Boolean
Aliases:CopyToPackageShareOnDistributionPoints
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 inclure aucun des caractères suivants : " / [ ] : | < > + = ; , ? * . Vous pouvez spécifier un nom de partage et un nom de dossier, mais le maximum pour chacun d’eux est de 80 caractères. Par exemple, ShareName\FolderName.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisconnectUserFromDistributionPoint

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

Type:Boolean
Aliases:DisconnectUsersFromDistributionPoints
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisconnectUserFromDistributionPointMins

Cette option est dépréciée. Il définit la propriété ForcedDisconnectDelay du package de pilotes.

Type:UInt32
Aliases:DisconnectUsersFromDistributionPointsMinutes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisconnectUserFromDistributionPointRetryCount

Cette option est dépréciée. Il définit la propriété ForcedDisconnectNumRetries du package de pilotes.

Type:UInt32
Aliases:DisconnectUsersFromDistributionPointsRetries
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DistributionPointUpdateSchedule

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

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DriverManufacturer

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

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DriverModel

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

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DriverPackageSource

Spécifiez un chemin d’accès au fichier vers l’emplacement réseau pour sourcer les fichiers 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. Le fournisseur SMS doit avoir des autorisations de contrôle total sur cet emplacement.

Lorsque vous ajoutez des pilotes de périphérique à un package de pilotes, Configuration Manager le 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
Default value:None
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Accept pipeline input:False
Accept wildcard characters: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
Aliases:PackageId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Spécifiez un objet de package de pilotes à configurer. Pour obtenir cet objet, utilisez l’cmdlet Get-CMDriverPackage.

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-MulticastAllow

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MulticastEncrypt

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-NewName

Spécifiez un nouveau nom pour le package de pilotes.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette cmdlet peut ne pas générer de sortie.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PrestageBehavior

Spécifiez le comportement lorsque vous activez un point de distribution pour le contenu déjà distribué :

  • ManualCopy: copier manuellement le contenu de ce package vers le point de distribution
  • DownloadDelta: Télécharger uniquement les modifications de contenu apportées au point de distribution
  • OnDemand: télécharger automatiquement le contenu lorsque des packages sont affectés à des points de distribution

Pour plus d’informations, voir Utiliser du contenu prétentaté.

Type:PrestageBehavior
Accepted values:ManualCopy, DownloadDelta, OnDemand
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 le contenu à priorité haute avant les packages de priorité moyenne ou faible. Les packages avec une priorité égale sont envoyés dans l’ordre dans lequel ils sont créés.

Type:Priority
Accepted values:High, Medium, Low
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SendToPreferredDistributionPoint

Si vous souhaitez activer la distribution de contenu à la demande sur les 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 du package et que le contenu n’est disponible sur aucun point de distribution, le point de gestion distribue le contenu. Pour plus d’informations, voir Distribution de contenu à la demande.

Type:Boolean
Aliases:SendToPreferredDistributionPoints
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Version

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object