New-CMTaskSequenceAutoPhasedDeployment

Référence

Module:: ConfigurationManager

Utilisez cette applet de commande pour créer un déploiement par phases pour une séquence de tâches en générant deux phases avec les mêmes paramètres.

Syntaxe

New-CMTaskSequenceAutoPhasedDeployment
   [-TaskSequence] <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-CMTaskSequenceAutoPhasedDeployment
   [-TaskSequenceId] <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-CMTaskSequenceAutoPhasedDeployment
   [-TaskSequenceName] <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>]

Description

Utilisez cette applet de commande pour créer un déploiement par phases pour une séquence de tâches 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 séquence de tâches, 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 de la séquence de tâches à un point de distribution.

Exemples

Exemple 1 : Créer un déploiement par nom de séquence de tâches

Cet exemple crée un déploiement par phases de séquence de tâches nommé myDPName pour la séquence de tâches myTaskSequenceName.

New-CMTaskSequenceAutoPhasedDeployment -TaskSequenceName "myTaskSequenceName" -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 séquence de tâches d’entrée

Cet exemple crée un déploiement par phases de séquence de tâches nommé myPDName pour un objet de séquence de tâches redirigé.

$myTS | New-CMTaskSequenceAutoPhasedDeployment -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-CMTaskSequencePhase 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 de séquence de tâches.

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 de séquence de tâches.

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

-TaskSequence

Spécifiez un objet de séquence de tâches.

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

-TaskSequenceId

Spécifiez une séquence de tâches par ID.

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

-TaskSequenceName

Spécifiez une séquence de tâches 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

-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

Sorties

IResultObject

Partager via