New-CMSoftwareUpdateAutoPhasedDeployment

Référence

Module:: ConfigurationManager

Utilisez cette applet de commande pour créer un déploiement par phases pour les mises à jour logicielles en générant deux phases avec les mêmes paramètres.

Syntaxe

New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateGroup] <IResultObject>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateGroupId] <String>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateGroupName] <String>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateIds] <String[]>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateNames] <String[]>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdates] <IResultObject[]>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour créer un déploiement par phases pour les mises à jour logicielles en générant deux phases avec les mêmes paramètres. Le comportement de cette applet de commande est le même que celui de l’Assistant Création d’un déploiement par phases sur une mise à jour logicielle, lorsque vous sélectionnez l’option Créer automatiquement un déploiement en deux phases par défaut.

Remarque

Avant de créer un déploiement par phases, veillez à distribuer le contenu des mises à jour logicielles à un point de distribution.

Exemples

Exemple 1 : Créer un déploiement par nom de mise à jour

Cet exemple crée un déploiement progressif de mise à jour logicielle nommé myDPName pour la mise à jour logicielle myUpdateName.

New-CMSoftwareUpdateAutoPhasedDeployment -SoftwareUpdateName "myUpdateName" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

Exemple 2 : Créer un déploiement par objet de mise à jour d’entrée

Cet exemple crée un déploiement progressif de mise à jour logicielle nommé myPDName pour un objet de mise à jour logicielle redirigé.

$myUpdate | New-CMSoftwareUpdateAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

Paramètres

-AddPhases

Cette applet de commande crée automatiquement deux phases pour les deux collections spécifiées. Vous pouvez également ajouter d’autres phases avec ce paramètre. Spécifiez un tableau de phases. Utilisez New-CMSoftwareUpdatePhase pour créer les phases.

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

-BeginCondition

Spécifiez une option pour commencer la deuxième phase de déploiement après la réussite de la première phase :

AfterPeriod: Ce paramètre est identique au paramètre suivant dans la page Paramètres de l’Assistant Création d’un déploiement par phases 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 l’Assistant Création d’un déploiement par phases dans la console : Commencez manuellement le déploiement de la deuxième phase.

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

-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 première phase :

Compliance: Ce paramètre est identique au paramètre suivant dans la page Paramètres de l’Assistant Création d’un déploiement par phases 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 l’Assistant Création d’un déploiement par phases 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 première phase pour commencer la deuxième phase. Ce paramètre est identique au paramètre suivant dans la page Paramètres de l’Assistant Création d’un déploiement par phases 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 l’Assistant Création d’un déploiement par phases 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

-Description

Spécifiez une description pour le déploiement par phases des mises à jour logicielles.

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

-FirstCollection

Spécifiez un objet de collection pour la première phase.

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

-FirstCollectionId

Spécifiez un ID de collection pour la première 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

-FirstCollectionName

Spécifiez un nom de collection pour la première 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

-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

-InsertAtOrder

Si vous utilisez le paramètre AddPhases , utilisez ce paramètre pour déterminer où, dans l’ordre des phases, insérer les phases supplémentaires. Spécifiez un entier avec le numéro d’ordre.

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

-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 l’Assistant Création d’un déploiement par phases 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 l’Assistant Création d’un déploiement par phases 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

-Name

Spécifiez un nom pour le déploiement par phases d’application.

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

-SecondCollection

Spécifiez un objet de collection pour la deuxième phase.

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

-SecondCollectionId

Spécifiez un ID de collection pour la deuxième 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

-SecondCollectionName

Spécifiez un nom de collection pour la deuxième 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

-SoftwareUpdateGroup

Spécifiez un objet pour le groupe de mises à jour logicielles.

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

-SoftwareUpdateGroupId

Spécifiez le groupe de mises à jour logicielles 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

-SoftwareUpdateGroupName

Spécifiez le groupe de mises à jour logicielles par 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

-SoftwareUpdateIds

Spécifiez un tableau d’ID de mise à jour logicielle.

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

-SoftwareUpdateNames

Spécifiez un tableau de noms de mises à jour logicielles.

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

-SoftwareUpdates

Spécifiez un tableau d’objets de mise à jour logicielle.

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

-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 l’Assistant Création d’un déploiement par phases 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

-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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Sorties

IResultObject

Partager via