Partager via

Set-CMSoftwareUpdatePhasedDeployment

  • Référence
Module:
ConfigurationManager

Configurez un déploiement par phases pour une mise à jour logicielle.

Syntaxe

Set-CMSoftwareUpdatePhasedDeployment
   [-AddPhases <Phase[]>]
   [-Description <String>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-RemovePhaseIds <String[]>]
   [-RemovePhaseOrders <Int32[]>]
   [-RemovePhases <Phase[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMSoftwareUpdatePhasedDeployment
   [-AddPhases <Phase[]>]
   [-Description <String>]
   [-NewName <String>]
   [-PassThru]
   [-RemovePhaseIds <String[]>]
   [-RemovePhaseOrders <Int32[]>]
   [-RemovePhases <Phase[]>]
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMSoftwareUpdatePhasedDeployment
   [-AddPhases <Phase[]>]
   [-Description <String>]
   [-NewName <String>]
   [-PassThru]
   [-RemovePhaseIds <String[]>]
   [-RemovePhaseOrders <Int32[]>]
   [-RemovePhases <Phase[]>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

S’applique à la version 2006 et ultérieure. Configurez un déploiement par phases pour une mise à jour logicielle. Pour plus d’informations, consultez Créer des déploiements par phases.

Exemples

Exemple 1 : Renommer un déploiement par phases

Cet exemple renomme un déploiement par phases de mise à jour logicielle transmis sur la ligne de commande.

$suPhasedDeployment = Get-CMSoftwareUpdatePhasedDeployment -Name "myPhasedDeployment"

$suPhasedDeployment | Set-CMSoftwareUpdatePhasedDeployment -NewName "New SU phased deployment" -Description "New description" -PassThru

Exemple 2 : Ajouter une phase

Cet exemple ajoute une phase à un déploiement par phases de mise à jour logicielle ciblé par son ID.

$newPhase = New-CMSoftwareUpdatePhase -CollectionName "MyCollection" -PhaseName "MySUPhase" -UserNotificationOption DisplaySoftwareCenterOnly

Set-CMSoftwareUpdatePhasedDeployment -Id "da0a01a3-b7ea-4d4b-8392-94b39ecabf8b" -AddPhases ($newPhase)

Paramètres

-AddPhases

Utilisez ce paramètre pour ajouter une ou plusieurs phases à un déploiement par phases de mise à jour logicielle. Utilisez l’applet de commande New-CMSoftwareUpdatePhase pour créer un objet phase.

Type:Phase[]
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:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Description

Spécifiez une description facultative pour mieux identifier ce déploiement par phases de mise à jour logicielle.

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

-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 du déploiement par phases de mise à jour logicielle à configurer. Le format de cette valeur est un GUID.

Type:String
Alias:PhasedDeploymentId
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 pour un déploiement par phases de mise à jour logicielle à configurer. Par exemple, utilisez l’applet de commande Get-CMSoftwareUpdatePhasedDeployment pour obtenir cet objet.

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

-Name

Spécifiez le nom du déploiement par phases de mise à jour logicielle à 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

Utilisez ce paramètre pour renommer le déploiement par phases de mise à jour logicielle.

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

Renvoie un objet représentant 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

-RemovePhaseIds

Supprimez une ou plusieurs phases spécifiées par leur ID.

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

-RemovePhaseOrders

Supprimez une ou plusieurs phases spécifiées par leur ordre dans le déploiement par phases.

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

-RemovePhases

Supprimer une ou plusieurs phases d’un déploiement par phases de mise à jour logicielle. Utilisez l’applet de commande Get-CMPhase pour identifier la phase à supprimer.

Type:Phase[]
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:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject