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