Partager via


Set-CMTaskSequence

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

Syntax

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 Configuration Manager applets de commande à 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[]
Aliases:AddSupportedOperatingSystemPlatforms
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BootImageId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
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:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Spécifie une description de la séquence de tâches.

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

-DisableTaskSequence

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

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

-EnableNotification

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

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

-EnableTaskSequence

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

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

-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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:TaskSequence
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaxRunTimeMins

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

Type:Int64
Aliases:Duration
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NewName

Spécifie un nouveau nom pour la séquence de tâches.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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[]
Aliases:RemoveSupportedOperatingSystemPlatforms
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:ClearSupportedOperatingSystemPlatforms
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SuppressNotification

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

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

-TaskSequenceId

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

Type:String
Aliases:Id, TaskSequencePackageId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TaskSequenceName

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

Type:String
Aliases:Name
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
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. Le cmdlet n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object