New-CMTaskSequenceAutoPhasedDeployment
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 pourcentageNumber: 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