New-CMTaskSequenceAutoPhasedDeployment
Utilisez cette cmdlet 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.
Syntax
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 cmdlet 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 cmdlet **** est identique à celui de l’Assistant Création d’un déploiement par phase sur une séquence de tâches, lorsque vous sélectionnez l’option de création automatique d’un déploiement à deux phasespar défaut.
Notes
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 canalisée.
$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
- Confirmer
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
- WhatIf
Présente ce qui se produit si le cmdlet s’exécute. La cmdlet ne s’exécute pas.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddPhases
Cette cmdlet 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 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 sur 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 sur 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 |
Accepted values: | AfterPeriod, Manually |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 sur 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 sur la **** page Paramètres de l’Assistant Création d’un déploiement par phases dans la console : Nombre d’appareils déployés avec succès. Spécifiez le nombre d’appareils avec le paramètre CriteriaValue.
Type: | CriteriaType |
Accepted values: | Compliance, Number |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CriteriaValue
Cette valeur entière dépend de la valeur que vous spécifiez pour CriteriaOption:
Compliance
: spécifier le pourcentageNumber
: spécifier le nombre d’appareils
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DaysAfterPreviousPhaseSuccess
Spécifiez une valeur d’un nombre total 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 sur 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 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineUnit
Spécifiez le type de période d’échéance. Utilisez ce paramètre avec DeadlineValue.
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineValue
Ce paramètre est utilisé uniquement si vous spécifiez AfterPeriod
avec le paramètre InstallationChoice.
Spécifiez une valeur de nombres longs pour la période 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 sur 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 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Spécifiez une description pour le déploiement par phases de la séquence de tâches.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Ce paramètre traite les caractères génériques comme des valeurs littérales. Vous ne pouvez pas la combiner avec ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FirstCollection
Spécifiez un objet de collection pour la première phase.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FirstCollectionId
Spécifiez un ID de collection pour la première phase.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FirstCollectionName
Spécifiez un nom de collection pour la première phase.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 nombre integer avec le numéro de commande.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstallationChoice
Spécifiez une option pour le comportement relatif à la mise à disposition du logiciel :
AsSoonAsPossible
: ce paramètre est identique au paramètre suivant sur 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 sur 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 |
Accepted values: | AsSoonAsPossible, AfterPeriod |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Spécifiez un nom pour le déploiement par phases de la séquence de tâches.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecondCollection
Spécifiez un objet de collection pour la deuxième phase.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecondCollectionId
Spécifiez un ID de collection pour la deuxième phase.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecondCollectionName
Spécifiez un nom de collection pour la deuxième phase.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TaskSequence
Spécifiez un objet de séquence de tâches.
Type: | IResultObject |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TaskSequenceId
Spécifiez une séquence de tâches par ID.
Type: | String |
Aliases: | TaskSequencePackageId |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TaskSequenceName
Spécifiez une séquence de tâches par nom.
Type: | String |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ThrottlingDays
Spécifiez une valeur d’un nombre total pour le nombre de jours pour rendre progressivement ce logiciel disponible. Ce paramètre est identique au paramètre suivant sur la **** page Paramètres de l’Assistant Création d’un déploiement progressif dans la console : rendre progressivement ce logiciel disponible sur cette période (en jours).
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Sorties
IResultObject