Partager via

Set-CMPackageDeployment

  • Référence
Module:
ConfigurationManager

Modifie les valeurs qui définissent la façon dont Configuration Manager déploie un package logiciel.

Syntaxe

Set-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Comment <String>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-EnableExpireSchedule <Boolean>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -InputObject <IResultObject>
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   -StandardProgramName <String>
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Comment <String>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-EnableExpireSchedule <Boolean>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageName <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   -StandardProgramName <String>
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Comment <String>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-EnableExpireSchedule <Boolean>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageId <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   -StandardProgramName <String>
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-Comment <String>]
   [-DeploymentStartDateTime <DateTime>]
   -DeviceProgramName <String>
   -PackageName <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseRecurrencePattern <Boolean>]
   [-UseUtc <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-Comment <String>]
   [-DeploymentStartDateTime <DateTime>]
   -DeviceProgramName <String>
   -PackageId <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseRecurrencePattern <Boolean>]
   [-UseUtc <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-Comment <String>]
   [-DeploymentStartDateTime <DateTime>]
   -DeviceProgramName <String>
   -InputObject <IResultObject>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseRecurrencePattern <Boolean>]
   [-UseUtc <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Set-CMPackageDeployment modifie les valeurs qui définissent la façon dont Configuration Manager déploie un package logiciel. Un déploiement comprend un ensemble d’appareils ou d’utilisateurs, un package à déployer et un nom de programme d’appareil ou un nom de programme standard. Pour spécifier le déploiement à modifier, spécifiez le nom de la collection, le package et le nom du programme. Vous pouvez spécifier le package par nom ou ID, ou vous pouvez utiliser l’applet de commande Get-CMPackage pour obtenir un objet de package.

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 : Définir les propriétés de périodicité

PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -RecurUnit Hours -RecurValue 7 -UseRecurrencePattern $True

Cette commande apporte des modifications au déploiement spécifié par le regroupement nommé Tous les systèmes, le programme d’appareil nommé DPM et le package nommé Outil de migration de l’état utilisateur pour Windows 8. La commande définit le paramètre UseRecurrencePattern sur une valeur de $True. La commande spécifie une unité de récurrité d’Heures et une valeur de récurrité de sept. Par conséquent, le déploiement se répète toutes les sept heures.

Exemple 2 : Définir le jour et l’heure de disponibilité

PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -PackageName "User State Migration Tool for Windows 8" -StandardProgramName "SPM" -DeploymentAvailableDay 2012/10/18 -DeploymentAvailableTime 15:41 -UseUtcForAvailableSchedule $False

Cette commande apporte des modifications au déploiement spécifié par le regroupement nommé Tous les systèmes, le package nommé User State Migration Tool pour Windows 8 et le programme standard nommé SPM. La commande spécifie un jour et une heure où le déploiement devient disponible. La commande spécifie également que le déploiement n’utilise pas utc pour la planification de la disponibilité. La planification fait référence au fuseau horaire local.

Paramètres

-AllowFallback

{{ Fill AllowFallback Description }}

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

-AllowSharedContent

Indique si les clients utilisent du contenu partagé. Si cette valeur est $True, les clients tentent de télécharger du contenu à partir d’autres clients qui ont téléchargé ce contenu. Si cette valeur est $False, les clients ne tentent pas de télécharger à partir d’autres clients.

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

-Collection

Spécifie la collection d’utilisateurs.

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

-CollectionId

Spécifie l’ID d’un regroupement d’appareils ou d’utilisateurs.

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

-CollectionName

Spécifie l’ID d’un regroupement d’appareils ou d’utilisateurs.

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:True

-Comment

Spécifie un commentaire pour le déploiement.

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

-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

-DeploymentAvailableDateTime

Spécifie, en tant qu’objet DateTime , la date et l’heure auxquelles le déploiement devient disponible. Pour obtenir un objet DateTime , utilisez l’applet de commande Get-Date.

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

-DeploymentExpireDateTime

Spécifie, en tant qu’objet DateTime , la date et l’heure d’expiration du déploiement. Pour obtenir un objet DateTime , utilisez l’applet de commande Get-Date .

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

-DeploymentStartDateTime

Spécifie, en tant qu’objet DateTime , la date et l’heure de début du déploiement. Pour obtenir un objet DateTime , utilisez l’applet de commande Get-Date .

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

-DeviceProgramName

Spécifie le nom d’un programme d’appareil.

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

-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

-EnableExpireSchedule

Indique s’il faut activer la planification pour faire expirer le déploiement.

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

-FastNetworkOption

Spécifie le comportement du client sur un réseau rapide. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • DownloadContentFromDistributionPointAndRunLocally
  • RunProgramFromDistributionPoint
Type:FastNetworkOptionType
Valeurs acceptées:RunProgramFromDistributionPoint, DownloadContentFromDistributionPointAndRunLocally
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

-InputObject

Spécifie un objet de package.

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

-PackageId

Spécifie l’ID d’un package.

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

-PackageName

Spécifie le nom d’un package.

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

-PassThru

Retourne l’objet de travail actuel. 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

-PersistOnWriteFilterDevice

Indique s’il faut activer les filtres d’écriture pour les appareils incorporés. Pour une valeur de $True, l’appareil valide les modifications pendant une fenêtre de maintenance. Cette action nécessite un redémarrage. Pour une valeur de $False, l’appareil enregistre les modifications dans une superposition et les valide ultérieurement.

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

-RecurUnit

Spécifie une unité pour un déploiement périodique. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Jours
  • Heures
  • Minutes
Type:RecurUnitType
Valeurs acceptées:Minutes, Hours, Days
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RecurValue

Spécifie la fréquence à laquelle un déploiement se répète. Ce paramètre dépend du type d’unité spécifié dans le paramètre RecurUnit . Cette valeur peut être comprise entre 1 et 23 si l’unité est Heures, entre 1 et 31 si l’unité est Jours, ou entre 1 et 59 si l’unité est Minutes.

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

-Rerun

Indique si le déploiement s’exécute à nouveau. Si cette valeur est $True, le déploiement s’exécute à nouveau pour les clients comme spécifié dans le paramètre RerunBehavior . Si cette valeur est $False, le déploiement ne s’exécute pas à nouveau.

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

-RerunBehavior

Spécifie la façon dont un déploiement s’exécute à nouveau sur un client. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • AlwaysRerunProgram. Réexécutez comme prévu, même si le déploiement a réussi. Vous pouvez utiliser cette valeur pour les déploiements récurrents.
  • NeverRerunDeployedProgram. Ne s’exécute pas à nouveau, même si le déploiement a échoué ou si des fichiers ont changé.
  • RerunIfFailedPreviousAttempt. Réexécutez, comme prévu, si le déploiement a échoué lors de la tentative précédente.
  • RerunIfSucceededOnpreviousAttempt. Réexécutez uniquement si la tentative précédente a réussi. Vous pouvez utiliser cette valeur pour les mises à jour qui dépendent de la mise à jour précédente.
Type:RerunBehaviorType
Valeurs acceptées:NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RunFromSoftwareCenter

Indique s’il faut exécuter à partir du centre logiciel.

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

-Schedule

Spécifie un objet CMSchedule . La planification spécifie quand la fenêtre de maintenance se produit. Pour créer un objet CMSchedule , 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

-ScheduleEvent

Spécifie un tableau de types d’événements de planification. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • AsSoonAsPossible
  • Déconnexion
  • LogOn
  • SendWakeUpPacket
Type:ScheduleEventType[]
Valeurs acceptées:AsSoonAsPossible, LogOn, LogOff
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SendWakeupPacket

Indique s’il faut envoyer un paquet de mise en éveil aux ordinateurs avant le début du déploiement. Si cette valeur est $True, Configuration Manager met un ordinateur en veille. Si cette valeur est $False, elle ne met pas en veille les ordinateurs. Pour que les ordinateurs sortent, vous devez d’abord configurer Wake On LAN.

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

-SlowNetworkOption

Spécifie comment Configuration Manager déploie ce package sur un réseau lent. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • DoNotRunProgram
  • DownloadContentFromDistributionPointAndLocally
  • RunProgramFromDistributionPoint
Type:SlowNetworkOptionType
Valeurs acceptées:DoNotRunProgram, DownloadContentFromDistributionPointAndLocally, RunProgramFromDistributionPoint
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SoftwareInstallation

Indique s’il faut installer le logiciel déployé en dehors des fenêtres de maintenance. Une fenêtre de maintenance est une période de temps spécifiée utilisée pour la maintenance et les mises à jour de l’ordinateur. Si cette valeur est $True, Configuration Manager installe le logiciel selon la planification, même si la planification est en dehors d’une fenêtre de maintenance. Si cette valeur est $False, Configuration Manager n’installe pas les logiciels déployés en dehors des fenêtres, mais attend une fenêtre de maintenance.

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

-StandardProgramName

Spécifie un nom de programme standard.

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

-SystemRestart

Indique si un système redémarre en dehors d’une fenêtre de maintenance. Une fenêtre de maintenance est une période de temps spécifiée utilisée pour la maintenance et les mises à jour de l’ordinateur. Si cette valeur est $True, tout redémarrage requis a lieu sans tenir compte des fenêtres de maintenance. Si cette valeur est $False, l’ordinateur ne redémarre pas en dehors d’une fenêtre de maintenance.

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

-UseMeteredNetwork

{{ Fill UseMeteredNetwork Description }}

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

-UseRecurrencePattern

Indique s’il faut utiliser un modèle de périodicité.

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

-UseUtc

Indique s’il faut utiliser le temps universel coordonné (UTC), également appelé heure moyenne de Greenwich. Si cette valeur est $True, Configuration Manager utilise l’utc pour ce déploiement. Si cette valeur est $False, Configuration Manager utilise l’heure locale.

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

-UseUtcForAvailableSchedule

Indique si l’heure utc doit être utilisée pour la planification disponible. Si cette valeur est $True, Configuration Manager utilise utc. Si cette valeur est $False, Configuration Manager utilise l’heure locale.

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

-UseUtcForExpireSchedule

Indique s’il faut utiliser l’utc pour la planification d’expiration. Si cette valeur est $True, Configuration Manager utilise utc. Si cette valeur est $False, Configuration Manager utilise l’heure locale.

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

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. Le cmdlet n’est pas exécutée.

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