Partager via


Set-CMPackage

Modifier un package.

Syntaxe

Set-CMPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetry <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-InputObject] <IResultObject>
   [-Language <String>]
   [-Manufacturer <String>]
   [-MifFileName <String>]
   [-MifName <String>]
   [-MifPublisher <String>]
   [-MifVersion <String>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priorities>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetry <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   -Id <String>
   [-Language <String>]
   [-Manufacturer <String>]
   [-MifFileName <String>]
   [-MifName <String>]
   [-MifPublisher <String>]
   [-MifVersion <String>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priorities>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetry <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-Language <String>]
   [-Manufacturer <String>]
   [-MifFileName <String>]
   [-MifName <String>]
   [-MifPublisher <String>]
   [-MifVersion <String>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priorities>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour modifier les paramètres d’un package. Pour plus d’informations, consultez Packages et programmes 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 : Renommer un package et ajouter une description

Cette commande renomme le package qui a l’ID ST120001scriptsPackage02 et ajoute une description.

Set-CMPackage -Id "ST120001" -NewName "ScriptsPackage02" -Description "This package deploys scripts that run on a recurring schedule."

Exemple 2 : Modifier le chemin d’accès source du package

La première commande obtient le package qui a l’ID ST120001 et stocke les résultats dans la variable $Pkg . La deuxième commande modifie le chemin d’accès source du package.

$pkg = Get-CMPackage -Id "ST120001"
Set-CMPackage -InputObject $pkg -Path "\\sources\cmpkg$\newpkg01"

Paramètres

-Confirm

Ajoutez ce paramètre pour demander la confirmation avant l’exécution de l’applet de commande.

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 à 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.

Type:Boolean
Alias:ShareContent, 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
Alias:ShareName
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 du package pour vous aider à l’identifier. Vous pouvez utiliser un maximum de 128 caractères.

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:ForceDisconnectEnabled, 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:ForcedDisconnectDelay, DisconnectUsersFromDistributionPointsMinutes, DisconnectUserFromDistributionPointsMins, DisconnectUserFromDistributionPointsMinutes
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisconnectUserFromDistributionPointRetry

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

Type:UInt32
Alias:ForceDisconnectNumRetries, 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

-EnableBinaryDeltaReplication

Définissez ce paramètre sur $true pour activer la réplication différentielle binaire (BDR). Pour plus d’informations, consultez Concepts fondamentaux pour la gestion de contenu dans 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

-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 à 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 à configurer. Pour obtenir cet objet, utilisez l’applet de commande Get-CMPackage .

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

-Language

Spécifiez une chaîne de langue pour le package. Vous pouvez utiliser un maximum de 32 caractères dans un format que vous choisissez d’utiliser pour identifier la version de la langue. Pour identifier un package, Configuration Manager utilise les paramètres Language, Manufacturer, Name et Version . Par exemple, vous pouvez avoir une version anglaise et une version allemande du même package.

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

-Manufacturer

Spécifiez le nom du fabricant du logiciel. Vous pouvez utiliser un maximum de 32 caractères. Pour identifier un package, Configuration Manager utilise les paramètres Language, Manufacturer, Name et Version .

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

-MifFileName

Spécifiez le nom du fichier MIF (Management Information Format) qui contient l’état du package. L’extension de nom de fichier doit être .mif. Utilisez un fichier MIF d’état pour générer des rapports d’état détaillés. Pour générer un fichier MIF d’état, votre application doit appeler la fonction InstallStatusMIF. Pour plus d’informations, consultez Fonctions MIF d’état.

Si vous définissez ce paramètre, lorsque le client exécute le déploiement, le client Configuration Manager recherche dans le %TEMP% répertoire ou dans le %windir% répertoire le fichier MIF d’état d’installation que vous spécifiez. L’état de l’installation indique si le programme s’est correctement exécuté.

Si le client ne trouve pas le fichier, il recherche tous les fichiers MIF dans ces répertoires. Il effectue une comparaison non sensible à la casse des valeurs que vous spécifiez pour MifName, MifPublisher et MifVersion avec les valeurs spécifiées par le fichier MIF. Si le client trouve une correspondance, il utilise l’état spécifié par le fichier MIF comme état d’installation du programme. S’il ne trouve pas de correspondance, ou si vous ne spécifiez pas MifFileName, le client utilise le code de sortie du programme pour définir l’état d’installation du programme. Un code de sortie égal à zéro indique que le programme s’est correctement exécuté. Toutes les autres valeurs indiquent des codes d’erreur spécifiques à l’application.

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

-MifName

Spécifiez le nom du package pour la correspondance MIF( jusqu’à 50 caractères). Pour plus d’informations, consultez le paramètre MifFileName .

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

-MifPublisher

Spécifiez l’éditeur de logiciel du package pour la correspondance MIF, jusqu’à 32 caractères. Pour plus d’informations, consultez le paramètre MifFileName .

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

-MifVersion

Spécifiez le numéro de version du package pour la correspondance MIF, jusqu’à 32 caractères. Pour plus d’informations, consultez le paramètre MifFileName .

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

-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 un nom de package. Vous pouvez utiliser un maximum de 250 caractères. Pour identifier un package, Configuration Manager utilise les paramètres Language, Manufacturer, Name et Version .

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

Utilisez ce paramètre pour renommer un package.

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

-Path

Si le package contient des fichiers sources, spécifiez l’emplacement des fichiers. Vous pouvez spécifier un chemin d’accès local complet sur le serveur de site ou un chemin d’accès réseau. Vérifiez que cet emplacement contient tous les fichiers et sous-répertoires que le programme doit exécuter, y compris les scripts.

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

-PersistContentInCache

Si vous ne souhaitez pas que le contenu de ce package sorte du cache du client pour laisser de l’espace pour d’autres contenus, définissez ce paramètre sur $true pour le conserver dans le cache du client.

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

-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é normale ou basse. Les packages avec une priorité égale sont envoyés dans l’ordre dans lequel ils sont créés.

Type:Priorities
Alias:DistributionPriority
Valeurs acceptées:High, Normal, 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 un numéro de version pour le logiciel. La longueur maximale de cette chaîne est de 32 caractères. Pour identifier un package, Configuration Manager utilise les paramètres Language, Manufacturer, Name et Version .

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