New-CMTaskSequencePhase
Utilisez cette applet de commande pour créer une phase de déploiement pour une séquence de tâches.
Syntax
New-CMTaskSequencePhase
[-AllowFallback <Boolean>]
[-AllowRemoteDP <Boolean>]
[-AllowSystemRestart <Boolean>]
[-BeginCondition <BeginConditionType>]
[-Collection] <IResultObject>
[-Comments <String>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-DeploymentOption <DeploymentOptionType>]
[-InstallationChoice <InstallationChoiceType>]
-PhaseName <String>
[-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>]
[-ThrottlingDays <Int32>]
[-UserNotification <UserNotificationType>]
[-WriteFilterCommit <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTaskSequencePhase
[-AllowFallback <Boolean>]
[-AllowRemoteDP <Boolean>]
[-AllowSystemRestart <Boolean>]
[-BeginCondition <BeginConditionType>]
[-CollectionId] <String>
[-Comments <String>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-DeploymentOption <DeploymentOptionType>]
[-InstallationChoice <InstallationChoiceType>]
-PhaseName <String>
[-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>]
[-ThrottlingDays <Int32>]
[-UserNotification <UserNotificationType>]
[-WriteFilterCommit <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTaskSequencePhase
[-AllowFallback <Boolean>]
[-AllowRemoteDP <Boolean>]
[-AllowSystemRestart <Boolean>]
[-BeginCondition <BeginConditionType>]
[-CollectionName] <String>
[-Comments <String>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-DeploymentOption <DeploymentOptionType>]
[-InstallationChoice <InstallationChoiceType>]
-PhaseName <String>
[-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>]
[-ThrottlingDays <Int32>]
[-UserNotification <UserNotificationType>]
[-WriteFilterCommit <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Utilisez cette applet de commande pour créer une phase de déploiement pour une séquence de tâches.
Exemples
Exemple 1 : Créer une phase de séquence de tâches
Cet exemple crée une phase de séquence de tâches nommée MyTSPhase pour la collection nommée MyCollection.
New-CMTaskSequencePhase -CollectionName "MyCollection" -PhaseName "MyTSPhase" -UserNotification DisplayAll -AllowRemoteDP $true
Paramètres
-AllowFallback
Ce paramètre est identique au paramètre suivant dans la page Points de distribution de l’Assistant Ajout d’une phase dans la console : Autoriser les clients à utiliser des points de distribution du groupe de limites de site par défaut.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowRemoteDP
Ce paramètre est identique au paramètre suivant dans la page Points de distribution de l’Assistant Ajout d’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 |
Required: | False |
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’AssistantAjout d’une phase dans la console : Redémarrage du système (si nécessaire pour terminer l’installation). Ce paramètre s’applique lorsque l’échéance d’installation est atteinte, pour permettre l’exécution de cette activité en dehors de la fenêtre de maintenance.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
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 dans la page Paramètres de phase de l’Assistant Ajout d’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 dans la page Paramètres de phase de l’Assistant Ajout d’une phase dans la console : Commencez manuellement cette phase de déploiement.
Type: | BeginConditionType |
Accepted values: | AfterPeriod, Manually |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
Spécifier un objet pour la collection cible
Type: | IResultObject |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
Spécifiez la collection cible par ID.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Spécifiez la collection cible par son nom.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
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 Paramètres de phase de l’Assistant Ajout d’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 dans la page Paramètres de phase de l’Assistant Ajout d’une phase 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 |
Required: | False |
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écifiez le pourcentageNumber
: spécifiez le nombre d’appareils
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DaysAfterPreviousPhaseSuccess
Spécifiez une valeur entière 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 dans la page Paramètres de phase de l’Assistant Ajout d’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 |
Required: | False |
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 |
Required: | False |
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 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 phase de l’Assistant Ajout d’une phase dans la console : L’installation est requise après cette période.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentOption
Ce paramètre est identique au paramètre suivant dans la page Points de distribution de l’Assistant Ajout d’une phase dans la console : sélectionnez l’option de déploiement à utiliser lorsqu’un client utilise un point de distribution d’un groupe de limites voisin ou du groupe de limites de site par 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écutionDownloadAllContentLocallyBeforeStartingTaskSequence
: Télécharger tout le contenu localement avant de commencer la séquence de tâches
Type: | DeploymentOptionType |
Accepted values: | DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 phase de l’Assistant Ajout d’une phase 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 phase de l’Assistant Ajout d’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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PhaseName
Spécifiez un nom pour la phase.
Type: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreDownload
Ce paramètre est identique au paramètre suivant dans la page Général de l’Assistant Ajout d’une phase dans la console : Prédécharger le contenu de cette séquence de tâches.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
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’AssistantAjout d’une phase dans la console : Installation de logiciels. Ce paramètre s’applique lorsque l’échéance d’installation est atteinte, pour permettre l’exécution de cette activité en dehors de la fenêtre de maintenance.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 phase de l’Assistant Ajout d’une phase dans la console : rendre progressivement ce logiciel disponible pendant cette période (en jours).
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserNotification
Ce paramètre est identique au paramètre suivant dans la page Expérience utilisateur de l’AssistantAjout d’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 notificationsHideAll
: Masquer dans le Centre logiciel et toutes les notifications
Type: | UserNotificationType |
Accepted values: | DisplayAll, HideAll |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WriteFilterCommit
Ce paramètre est identique au paramètre suivant dans la page Expérience utilisateur de l’Assistant Ajout d’une phase dans la console : Valider les modifications à l’échéance ou pendant une fenêtre de maintenance (redémarrage requis). Ce paramètre s’applique à la gestion des filtres d’écriture pour les appareils Windows Embedded.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
None
Sorties
Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour