Set-CMTaskSequencePhase

Référence

Module:: ConfigurationManager

Utilisez cette cmdlet pour configurer une phase de déploiement pour une séquence de tâches.

Syntax

Set-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-Comments <String>]
   [-DeploymentOption <DeploymentOptionType>]
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-MovePhase <ReorderType>]
   [-MoveToOrder <Int32>]
   [-NewCollection <IResultObject>]
   [-NewCollectionId <String>]
   [-NewCollectionName <String>]
   [-NewPhaseName <String>]
   [-ThrottlingDays <Int32>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Id <String>]
   [-InputObject] <IResultObject>
   [-Name <String>]
   [-Order <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-Comments <String>]
   [-DeploymentOption <DeploymentOptionType>]
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-MovePhase <ReorderType>]
   [-MoveToOrder <Int32>]
   [-NewCollection <IResultObject>]
   [-NewCollectionId <String>]
   [-NewCollectionName <String>]
   [-NewPhaseName <String>]
   [-ThrottlingDays <Int32>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Id <String>]
   [-Name <String>]
   [-Order <Int32>]
   [-PhasedDeploymentId] <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-Comments <String>]
   [-DeploymentOption <DeploymentOptionType>]
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-MovePhase <ReorderType>]
   [-MoveToOrder <Int32>]
   [-NewCollection <IResultObject>]
   [-NewCollectionId <String>]
   [-NewCollectionName <String>]
   [-NewPhaseName <String>]
   [-ThrottlingDays <Int32>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Id <String>]
   [-Name <String>]
   [-Order <Int32>]
   [-PhasedDeploymentName] <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

S’applique aux versions 2006 et ultérieures. Utilisez cette cmdlet pour configurer une phase de déploiement pour une séquence de tâches. Pour plus d’informations, voir Créer des déploiements par phases.

Exemples

Exemple 1 : Modifier la collection

Cet exemple modifie la collection de la deuxième phase du déploiement par phases de la séquence de tâches transmise sur la ligne de commande.

$phasedDeployment = Get-CMTaskSequencePhasedDeployment -Name "myPhasedDeployment"

$phasedDeployment | Set-CMTaskSequencePhase -Order 2 -NewCollectionId "XYZ00227"

Exemple 2 : Déplacer une phase vers le haut

Cet exemple déplace une phase vers le haut dans l’ordre. Il sélectionne le déploiement par phases par son ID et sélectionne la phase par L’ID de collection associé.

Set-CMTaskSequencePhase -PhasedDeploymentId "0bc464d9-e7dd-44c1-a157-3f8be6a79c03" -CollectionId "XYZ00227" -MovePhase MoveUp

Exemple 3 : Configurer les paramètres de phase

Cet exemple modifie les paramètres de configuration de la phase sélectionnée.

Set-CMTaskSequencePhase -PhasedDeploymentName "myPhasedDeployment" -Name "phase1" -UserNotification HideAll -SoftwareInstallation $true -AllowSystemRestart $true -WriteFilterCommit $false -PreDownload $true -Comments "phase 1 comment" -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowRemoteDP $true -AllowFallback $false -CriteriaOption Compliance -CriteriaValue 90 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 3 -ThrottlingDays 5 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 12

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

-AllowFallback

Ce paramètre est identique au paramètre suivant sur la page Points de distribution de l’Assistant Ajouter une phase dans la console : Autoriser les clients à utiliser des points de distribution à partir du groupe de limites de site par défaut.

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowRemoteDP

Ce paramètre est identique au paramètre suivant sur la page Points de distribution de l’Assistant Ajouter une phase dans la console : Lorsqu’aucun point de distribution local n’est disponible, utilisez un point de distribution distant.

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowSystemRestart

Ce paramètre est identique au paramètre suivant dans la page Expérience utilisateur de l’Assistant Ajouter une phase dans la console : redémarrage du système (si nécessaire pour terminer l’installation). Ce paramètre s’applique lorsque la date d’échéance de l’installation est atteinte, pour permettre à cette activité d’être effectuée en dehors de la fenêtre de maintenance.

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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 sur la page Phase Paramètres de l’Assistant Ajouter 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 sur la page Phase Paramètres de l’Assistant Ajouter une phase dans la console : commencez manuellement cette phase de déploiement.

Type:	BeginConditionType
Accepted values:	AfterPeriod, Manually
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Collection

Spécifier un objet pour la collection cible

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionId

Spécifiez la collection cible par ID.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionName

Spécifiez la collection cible par nom.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Comments

Spécifiez des commentaires facultatifs pour cette phase. La longueur maximale est de 512 caractères.

Type:	String
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 phase précédente :

Compliance: ce paramètre est identique au paramètre suivant dans la page Phase Paramètres de l’Assistant Ajouter 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 sur la page Phase Paramètres de l’Assistant Phase d’ajout dans la console : Nombre d’appareils correctement déployé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 pourcentage
Number: 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 phase précédente pour commencer cette phase. Ce paramètre est identique au paramètre suivant sur la page Phase Paramètres de l’Assistant Ajouter une phase 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 Phase Paramètres de l’Assistant Ajouter une phase 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

-DeploymentOption

Ce paramètre est identique au paramètre suivant sur la page Points de distribution de l’Assistant Ajouter une phase dans la console : Sélectionnez l’option de déploiement à utiliser lorsqu’un client utilise un point de distribution à partir d’un groupe de limites voisin ou du groupe de limites de sitepar défaut. Il accepte les valeurs suivantes :

DownloadContentLocallyWhenNeededByRunningTaskSequence: Télécharger le contenu localement si nécessaire par la séquence de tâches en cours d’exécution
DownloadAllContentLocallyBeforeStartingTaskSequence: Télécharger tout le contenu localement avant de démarrer la séquence de tâches

Type:	DeploymentOptionType
Accepted values:	DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence
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

-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

-Id

Spécifiez l’ID de la phase à configurer.

Type:	String
Aliases:	PhaseId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Spécifiez un objet de déploiement par phases qui inclut la phase à configurer.

Type:	IResultObject
Aliases:	PhasedDeployment
Position:	0
Default value:	None
Accept pipeline input:	True
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 Phase Paramètres de l’Assistant Ajouter une phase dans la console : l’installation est requise dès que possible.
AfterPeriod: Ce paramètre est identique au paramètre suivant sur la page Phase Paramètres de l’Assistant Ajouter 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
Accepted values:	AsSoonAsPossible, AfterPeriod
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MovePhase

Modifiez l’ordre de la phase sélectionnée. Vous pouvez le déplacer vers le haut, vers le bas ou vers un index spécifique. Si vous MoveToOrder spécifiez , utilisez le paramètre -MoveToOrder pour définir l’index spécifique.

Type:	ReorderType
Accepted values:	MoveUp, MoveDown, MoveToOrder
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MoveToOrder

Lorsque vous définissez le paramètre -MovePhase sur , utilisez ce paramètre MoveToOrder pour définir l’index spécifique.

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Spécifiez le nom de la phase à configurer.

Type:	String
Aliases:	PhaseName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NewCollection

Spécifiez un objet de collection à utiliser comme nouvelle cible pour la phase sélectionnée.

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NewCollectionId

Spécifiez une collection par ID à utiliser comme nouvelle cible pour la phase sélectionnée.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NewCollectionName

Spécifiez une collection par nom à utiliser comme nouvelle cible pour la phase sélectionnée.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NewPhaseName

Utilisez ce paramètre pour renommer la phase sélectionnée.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Order

Spécifiez l’index de la phase à configurer.

Type:	Int32
Aliases:	PhaseOrder
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PhasedDeploymentId

Sélectionnez le déploiement par phases par ID. Utilisez ensuite d’autres paramètres pour sélectionner la phase spécifique de ce déploiement.

Type:	String
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PhasedDeploymentName

Sélectionnez le déploiement par phases par nom. Utilisez ensuite d’autres paramètres pour sélectionner la phase spécifique de ce déploiement.

Type:	String
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PreDownload

Ce paramètre est identique au paramètre suivant sur la page Général de l’Assistant Ajouter une phase dans la console : Pré-téléchargerle contenu de cette séquence de tâches.

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SoftwareInstallation

Ce paramètre est identique au paramètre suivant dans la page Expérience utilisateur de l’Assistant Ajouter une phase dans la console : Installation de logiciels. Ce paramètre s’applique lorsque la date d’échéance de l’installation est atteinte, pour permettre à cette activité d’être effectuée en dehors de la fenêtre de maintenance.

Type:	Boolean
Position:	Named
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 Phase Paramètres de l’Assistant Ajouter une phase 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

-UserNotification

Ce paramètre est identique au paramètre suivant sur la page Expérience utilisateur **** de l’Assistant Ajouter 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
HideAll: Masquer dans le Centre de logiciels et toutes les notifications

Type:	UserNotificationType
Accepted values:	DisplayAll, HideAll
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WriteFilterCommit

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject

Partager via