Partager via


New-CMSoftwareUpdatePhase

Utilisez cette applet de commande pour créer une phase de déploiement pour la mise à jour logicielle.

Syntaxe

New-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-Collection] <IResultObject>
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InstallationChoice <InstallationChoiceType>]
   [-PhaseDescription <String>]
   -PhaseName <String>
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-ThrottlingDays <Int32>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionId] <String>
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InstallationChoice <InstallationChoiceType>]
   [-PhaseDescription <String>]
   -PhaseName <String>
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-ThrottlingDays <Int32>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionName] <String>
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InstallationChoice <InstallationChoiceType>]
   [-PhaseDescription <String>]
   -PhaseName <String>
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-ThrottlingDays <Int32>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour créer une phase de déploiement pour la mise à jour logicielle.

Exemples

Exemple 1 : Créer une phase de mise à jour logicielle

Cet exemple crée une phase de mise à jour logicielle nommée MySUPhase pour la collection nommée MyCollection qui s’affiche uniquement dans le Centre logiciel.

New-CMSoftwareUpdatePhase `
 -CollectionName "MyCollection" `
 -PhaseName "MySUPhase" `
 -UserNotificationOption DisplaySoftwareCenterOnly

Paramètres

-AlertDelta

Ce paramètre est identique au paramètre suivant dans la page Alertes de l’Assistant Ajout d’une phase dans la console : Décalage par rapport à l’heure d’échéance. Spécifiez une valeur entière pour le décalage, puis spécifiez le type de période avec le paramètre AlertUnit .

Pour définir cette valeur, vous devez utiliser le paramètre EnableAlert .

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

-AlertThresholdPercentage

Ce paramètre est identique au paramètre suivant dans la page Alertes de l’Assistant Ajout d’une phase dans la console : La conformité du client est inférieure à (pourcentage) suivante. Spécifiez une valeur entière pour le pourcentage. Pour définir cette valeur, vous devez utiliser le paramètre EnableAlert .

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

-AlertUnit

Spécifiez le type de point. Utilisez ce paramètre avec AlertDelta.

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

-AllowMeteredConnection

Ce paramètre est identique au paramètre suivant dans la page Paramètres de téléchargement de l’Assistant Ajout d’une phase dans la console : Autoriser les clients sur une connexion Internet limitée à télécharger du contenu après l’échéance de l’installation, ce qui peut entraîner des coûts supplémentaires.

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

-AllowSystemRestart

Ce paramètre est identique au paramètre suivant dans la page Expérience utilisateur de l’AssistantAjout d’une phase dans la console : Redémarrage du système (si nécessaire pour terminer l’installation). Ce paramètre s’applique lorsque l’échéance d’installation est atteinte, pour permettre l’exécution de cette activité en dehors de la 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

-AllowWumuFallback

Ce paramètre est identique au paramètre suivant dans la page Paramètres de téléchargement de l’Assistant Ajout d’une phase dans la console : Si les mises à jour logicielles ne sont pas disponibles sur le point de distribution dans les groupes de limites actuels, voisins ou de site, téléchargez le contenu à partir de Microsoft Updates.

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

-BeginCondition

Spécifiez une option pour commencer cette phase de déploiement après la réussite de la phase précédente :

  • AfterPeriod: Ce paramètre est identique au paramètre suivant dans la page Paramètres de phase de l’Assistant Ajout d’une phase dans la console : Commencez automatiquement cette phase après une période de report (en jours). Si vous spécifiez cette valeur, utilisez DaysAfterPreviousPhaseSuccess pour configurer la période.

  • Manually: Ce paramètre est identique au paramètre suivant dans la page Paramètres de phase de l’Assistant Ajout d’une phase dans la console : Commencez manuellement cette phase de déploiement.

Type:BeginConditionType
Valeurs acceptées:AfterPeriod, Manually
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écifiez un objet pour la collection cible.

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

-CollectionId

Spécifiez la collection cible par ID.

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

-CollectionName

Spécifiez la collection cible par son nom.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
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

-CriteriaOption

Spécifiez une option pour choisir les critères de réussite de la phase précédente :

  • Compliance: ce paramètre est identique au paramètre suivant dans la page Paramètres de phase de l’Assistant Ajout d’une phase dans la console : Pourcentage de réussite du déploiement. Spécifiez la valeur de pourcentage avec le paramètre CriteriaValue .

  • Number: Ce paramètre est identique au paramètre suivant dans la page Paramètres de phase de l’Assistant Ajout d’une phase dans la console : Nombre d’appareils correctement déployés. Spécifiez le nombre d’appareils avec le paramètre CriteriaValue .

Type:CriteriaType
Valeurs acceptées:Compliance, Number
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CriteriaValue

Cette valeur entière dépend de la valeur que vous spécifiez pour CriteriaOption :

  • Compliance: spécifiez le pourcentage

  • Number: spécifiez le nombre d’appareils

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

-DaysAfterPreviousPhaseSuccess

Spécifiez une valeur entière pour le nombre de jours après la réussite de la phase précédente pour commencer cette phase. Ce paramètre est identique au paramètre suivant dans la page Paramètres de phase de l’Assistant Ajout d’une phase dans la console : commencez automatiquement cette phase après une période de report (en jours).

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

-DeadlineUnit

Spécifiez le type de période d’échéance. Utilisez ce paramètre avec DeadlineValue.

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

-DeadlineValue

Ce paramètre est utilisé uniquement si vous spécifiez AfterPeriod avec le paramètre InstallationChoice .

Spécifiez une valeur entière pour la période de temps de l’échéance. Utilisez le paramètre DeadlineUnit pour spécifier le type de point : Hours, Days, Weeks, Months. Ce paramètre est identique au paramètre suivant dans la page Paramètres de phase de l’Assistant Ajout d’une phase dans la console : L’installation est requise après cette période.

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

-DisableScomAlert

Ce paramètre est identique au paramètre suivant dans la page Alertes de l’Assistant Ajout d’une phase dans la console : Désactiver les alertes Operations Manager pendant l’exécution des mises à jour logicielles.

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

-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

-EnableAlert

Ce paramètre est identique au paramètre suivant dans la page Alertes de l’Assistant Ajout d’une phase dans la console : Générer une alerte lorsque les conditions suivantes sont remplies. Lorsque vous définissez ce paramètre sur $true, définissez également les paramètres suivants :

  • AlertThresholdPercentage
  • AlertDelta
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

-EnableWakeOnLan

Ce paramètre est identique au paramètre suivant dans la page Paramètres de déploiement de l’Assistant Ajout d’une phase dans la console : Utiliser Wake-on-LAN pour mettre en éveil les clients pour les déploiements requis.

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. Ce n’est pas 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

-GenerateScomAlertOnFailure

Ce paramètre est identique au paramètre suivant dans la page Alertes de l’Assistant Ajout d’une phase dans la console : Générer une alerte Operations Manager en cas d’échec de l’installation d’une mise à jour logicielle.

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

-InstallationChoice

Spécifiez une option pour le comportement relatif au moment où le logiciel est mis à disposition :

  • AsSoonAsPossible: Ce paramètre est identique au paramètre suivant dans la page Paramètres de phase de l’Assistant Ajout d’une phase dans la console : L’installation est requise dès que possible.

  • AfterPeriod: Ce paramètre est identique au paramètre suivant dans la page Paramètres de phase de l’Assistant Ajout d’une phase dans la console : L’installation est requise après cette période. Si vous spécifiez cette valeur, utilisez DeadlineUnit et DeadlineValue pour configurer la période.

Type:InstallationChoiceType
Valeurs acceptées:AsSoonAsPossible, AfterPeriod
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PhaseDescription

Spécifiez une description de la phase.

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

-PhaseName

Spécifiez un nom pour la description.

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

-RequirePostRebootFullScan

Ce paramètre est identique au paramètre suivant dans la page Expérience utilisateur de l’Assistant Ajout d’une phase dans la console : si une mise à jour de ce déploiement nécessite un redémarrage du système, exécutez le cycle d’évaluation du déploiement des mises à jour après le redémarrage.

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

-ServerRestartSuppression

Ce paramètre est identique au paramètre suivant dans la page Expérience utilisateur de l’Assistant Ajout de phase dans la console. Supprimez le redémarrage du système sur les appareils suivants : Serveurs.

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

-SoftwareInstallation

Ce paramètre est identique au paramètre suivant dans la page Expérience utilisateur de l’AssistantAjout de phase dans la console : Installation de logiciels. Ce paramètre s’applique lorsque l’échéance d’installation est atteinte, pour permettre l’exécution de cette activité en dehors de la 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

-StateMessageVerbosity

Ce paramètre est identique au paramètre suivant dans la page Paramètres de déploiement de l’Assistant Ajout d’une phase dans la console : Niveau de détail du message d’état avec les valeurs suivantes :

  • AllMessages: Tous les messages
  • OnlySuccessAndErrorMessages: seuls les messages de réussite et d’erreur
  • OnlyErrorMessages: messages d’erreur uniquement
Type:VerbosityLevelType
Valeurs acceptées:AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ThrottlingDays

Spécifiez une valeur entière pour le nombre de jours pour rendre progressivement ce logiciel disponible. Ce paramètre est identique au paramètre suivant dans la page Paramètres de phase de l’Assistant Ajout d’une phase dans la console : rendre progressivement ce logiciel disponible pendant cette période (en jours).

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

-UseNeighborDP

Ce paramètre est identique au paramètre suivant dans la page Paramètres de téléchargement de l’Assistant Ajout d’une phase dans la console : sélectionnez l’option de déploiement à utiliser lorsqu’un client utilise un point de distribution d’un groupe de limites voisin ou du groupe de limites de site par défaut. Spécifiez les valeurs suivantes :

  • $true: Télécharger les mises à jour logicielles à partir du point de distribution et installer
  • $false: Ne pas installer les mises à jour logicielles
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

-UserNotificationOption

Ce paramètre est identique au paramètre suivant dans la page Expérience utilisateur de l’AssistantAjout d’une phase dans la console : Spécifiez le paramètre d’expérience utilisateur pour ce déploiement avec les valeurs suivantes :

  • DisplayAll: Afficher dans le Centre logiciel et afficher toutes les notifications
  • DisplaySoftwareCenterOnly: Afficher dans le Centre logiciel et afficher uniquement les notifications pour les redémarrages de l’ordinateur
  • HideAll: Masquer dans le Centre logiciel et toutes les notifications
Type:UserNotificationType
Valeurs acceptées:DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UseSiteDefaultDP

Ce paramètre est identique au paramètre suivant dans la page Paramètres de téléchargement de l’Assistant Ajout d’une phase dans la console : Lorsque les mises à jour logicielles ne sont disponibles sur aucun point de distribution du groupe de limites actuel ou voisin, le client peut télécharger et installer des mises à jour logicielles à partir de points de distribution dans le groupe de limites par défaut du site. Spécifiez les valeurs suivantes :

  • $true: Télécharger et installer les mises à jour logicielles à partir des points de distribution dans le groupe de limites de site par défaut
  • $false: Ne pas installer les mises à jour logicielles
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. 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

-WorkstationRestartSuppression

Ce paramètre est identique au paramètre suivant dans la page Expérience utilisateur de l’Assistant Ajout de phase dans la console. Supprimez le redémarrage du système sur les appareils suivants : Stations de travail.

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

-WriteFilterCommit

Ce paramètre est identique au paramètre suivant dans la page Expérience utilisateur de l’Assistant Ajout d’une phase dans la console : Valider les modifications à l’échéance ou pendant une fenêtre de maintenance (redémarrage requis). Ce paramètre s’applique à la gestion des filtres d’écriture pour les appareils Windows Embedded.

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

Entrées

None

Sorties

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase