Set-CMTaskSequence

Module:

ConfigurationManager

Définit une séquence de tâches Configuration Manager.

Syntaxe

Set-CMTaskSequence
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-BootImageId <String>]
   [-Category <String>]
   [-CustomText <String>]
   [-DeploymentPackageId <String>]
   [-Description <String>]
   [-DisableTaskSequence <Boolean>]
   [-EnableNotification <Boolean>]
   [-EnableTaskSequence <Boolean>]
   [-HighPerformance <Boolean>]
   -InputObject <IResultObject>
   [-MaxRunTimeMins <Int64>]
   [-NewName <String>]
   [-PassThru]
   [-ProgramName <String>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-RunAnotherProgram <Boolean>]
   [-RunEveryTime <Boolean>]
   [-RunOnAnyPlatform]
   [-SuppressNotification <Boolean>]
   [-UseBootImage <Boolean>]
   [-UseDefaultText <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequence
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-BootImageId <String>]
   [-Category <String>]
   [-CustomText <String>]
   [-DeploymentPackageId <String>]
   [-Description <String>]
   [-DisableTaskSequence <Boolean>]
   [-EnableNotification <Boolean>]
   [-EnableTaskSequence <Boolean>]
   [-HighPerformance <Boolean>]
   [-MaxRunTimeMins <Int64>]
   [-NewName <String>]
   [-PassThru]
   [-ProgramName <String>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-RunAnotherProgram <Boolean>]
   [-RunEveryTime <Boolean>]
   [-RunOnAnyPlatform]
   [-SuppressNotification <Boolean>]
   -TaskSequenceId <String>
   [-UseBootImage <Boolean>]
   [-UseDefaultText <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequence
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-BootImageId <String>]
   [-Category <String>]
   [-CustomText <String>]
   [-DeploymentPackageId <String>]
   [-Description <String>]
   [-DisableTaskSequence <Boolean>]
   [-EnableNotification <Boolean>]
   [-EnableTaskSequence <Boolean>]
   [-HighPerformance <Boolean>]
   [-MaxRunTimeMins <Int64>]
   [-NewName <String>]
   [-PassThru]
   [-ProgramName <String>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-RunAnotherProgram <Boolean>]
   [-RunEveryTime <Boolean>]
   [-RunOnAnyPlatform]
   [-SuppressNotification <Boolean>]
   -TaskSequenceName <String>
   [-UseBootImage <Boolean>]
   [-UseDefaultText <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Set-CMTaskSequence modifie une séquence de tâches Configuration Manager.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Obtenir une séquence de tâches et modifier son nom

PS XYZ:\> $TaskSequence = Get-CMTaskSequence -Name "TaskSequence01"
PS XYZ:\> Set-CMTaskSequence -InputObject $TaskSequence -NewName "NewTS01"

La première commande obtient l’objet de séquence de tâches nommé TaskSequence01 et stocke l’objet dans la variable $TaskSequence.

La deuxième commande remplace le nom de la séquence de tâches stockée dans $TaskSequence par NewTS01.

Exemple 2 : Passer une séquence de tâches et modifier son nom

PS XYZ:\> Get-CMTaskSequence -Name "TaskSequence02" | Set-CMTaskSequence -NewName "NewTS02"

Cette commande obtient l’objet de séquence de tâches nommé TaskSequence02 et utilise l’opérateur de pipeline pour passer l’objet à Set-CMTaskSequence, qui remplace le nom de l’objet de séquence de tâches par NewTS02.

Paramètres

-AddSupportedOperatingSystemPlatform

Ajoute un objet de plateforme de système d’exploitation pris en charge à la séquence de tâches. Pour obtenir un objet de plateforme de système d’exploitation pris en charge, utilisez l’applet de commande Get-CMSupportedPlatform .

Type:	IResultObject[]
Alias:	AddSupportedOperatingSystemPlatforms
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-BootImageId

Spécifie l’ID d’une image de démarrage.

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

-Category

Spécifie une catégorie pour la séquence de tâches. Vous pouvez utiliser des catégories pour regrouper des séquences 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

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-CustomText

Spécifie le texte personnalisé pour la séquence de tâches. Le texte personnalisé apparaît dans la boîte de dialogue de notification de progression pendant l’exécution de la 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

-DeploymentPackageId

Spécifie l’ID d’un package. Si vous spécifiez une valeur de $True pour le paramètre RunAnotherProgram , le package spécifié s’exécute avant l’exécution de la 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

-Description

Spécifie une description de la 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

-DisableTaskSequence

Indique s’il faut désactiver cette séquence de tâches.

Type:	Boolean
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

-EnableNotification

Indique s’il faut activer les notifications pour cette séquence de tâches.

Type:	Boolean
Alias:	EnableNotifications
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-EnableTaskSequence

Indique s’il faut activer cette séquence de tâches.

Type:	Boolean
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 (non 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

-HighPerformance

Utilisez ce paramètre pour définir l’option suivante dans la page Performances des propriétés de la séquence de tâches : Exécuter en tant que mode d’alimentation haute performance.

Type:	Boolean
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-InputObject

Spécifie un objet de séquence de tâches. Pour obtenir un objet de séquence de tâches, utilisez l’applet de commande Get-CMTaskSequence .

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

-MaxRunTimeMins

Spécifie, en minutes, la durée d’exécution maximale de la séquence de tâches.

Type:	Int64
Alias:	Duration
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-NewName

Spécifie un nouveau nom pour la 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

-PassThru

Retourne l’objet de travail actuel. Par défaut, cette applet de commande ne génère aucune sortie.

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

-ProgramName

Spécifie le nom d’un programme à exécuter à partir d’un package logiciel Configuration Manager spécifié par le paramètre DeploymentPackageId .

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

-RemoveSupportedOperatingSystemPlatform

Supprime un objet de plateforme de système d’exploitation pris en charge de la séquence de tâches. Pour obtenir un objet de plateforme de système d’exploitation pris en charge, utilisez l’applet de commande Get-CMSupportedPlatform .

Type:	IResultObject[]
Alias:	RemoveSupportedOperatingSystemPlatforms
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RunAnotherProgram

Indique s’il faut exécuter un autre programme avant d’exécuter la séquence de tâches. Spécifiez le programme à l’aide des paramètres DeploymentPackageId et ProgramName .

Type:	Boolean
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RunEveryTime

Indique si le programme spécifié dans le paramètre ProgramName s’exécute chaque fois que la séquence de tâches s’exécute. Si vous spécifiez une valeur de $False, le programme ne s’exécute pas s’il s’est exécuté correctement dans le passé.

Type:	Boolean
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RunOnAnyPlatform

Indique que la séquence de tâches s’exécute sur n’importe quelle plateforme de système d’exploitation.

Type:	SwitchParameter
Alias:	ClearSupportedOperatingSystemPlatforms
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-SuppressNotification

Indique s’il faut supprimer les notifications pour cette séquence de tâches.

Type:	Boolean
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-TaskSequenceId

Spécifie l’ID d’une séquence de tâches.

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

-TaskSequenceName

Spécifie le nom d’une séquence de tâches.

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

-UseBootImage

Indique si la séquence de tâches utilise l’image de démarrage spécifiée à l’aide du paramètre BootImageID .

Type:	Boolean
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-UseDefaultText

Indique s’il faut utiliser le texte par défaut dans la boîte de dialogue de notification de progression pendant l’exécution de la séquence de tâches. Si vous sélectionnez une valeur de $False pour ce paramètre, veillez à spécifier du texte personnalisé à l’aide du paramètre CustomText .

Type:	Boolean
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. Le cmdlet n’est pas exécutée.

Type:	SwitchParameter
Alias:	wi
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object

Liens associés

• New-CMTaskSequence
• Get-CMTaskSequence
• Copy-CMTaskSequence
• Import-CMTaskSequence
• Export-CMTaskSequence
• Remove-CMTaskSequence
• Get-CMSupportedPlatform