Set-CMTaskSequence

设置 Configuration Manager 任务序列。

语法

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>]

说明

Set-CMTaskSequence cmdlet 修改 Configuration Manager 任务序列。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>。 有关详细信息,请参阅 入门

示例

示例 1:获取任务序列并更改其名称

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

第一个命令获取名为 TaskSequence01 的任务序列对象,并将对象存储在 $TaskSequence 变量中。

第二个命令将存储在 $TaskSequence 中的任务序列的名称更改为 NewTS01。

示例 2:传递任务序列并更改其名称

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

此命令获取名为 TaskSequence02 的任务序列对象,并使用管道运算符将对象传递给 Set-CMTaskSequence,这将任务序列对象的名称更改为 NewTS02。

参数

-AddSupportedOperatingSystemPlatform

将支持的操作系统平台对象添加到任务序列。 若要获取支持的操作系统平台对象,请使用 Get-CMSupportedPlatform cmdlet。

类型:IResultObject[]
别名:AddSupportedOperatingSystemPlatforms
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-BootImageId

指定启动映像的 ID。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Category

指定任务序列的类别。 可以使用类别对任务序列进行分组。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-CustomText

指定任务序列的自定义文本。 任务序列运行时,自定义文本将显示在进度通知对话框中。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DeploymentPackageId

指定包的 ID。 如果为 RunAnotherProgram 参数指定值 $True,则指定的包在任务序列运行之前运行。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Description

指定任务序列的说明。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DisableTaskSequence

指示是否禁用此任务序列。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EnableNotification

指示是否为此任务序列启用通知。

类型:Boolean
别名:EnableNotifications
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EnableTaskSequence

指示是否启用此任务序列。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForceWildcardHandling

此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-HighPerformance

使用此参数可在任务序列属性的“ 性能 ”页上设置以下选项: 作为高性能电源计划运行

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InputObject

指定任务序列对象。 若要获取任务序列对象,请使用 Get-CMTaskSequence cmdlet。

类型:IResultObject
别名:TaskSequence
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-MaxRunTimeMins

指定任务序列的最大运行时间(以分钟为单位)。

类型:Int64
别名:Duration
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-NewName

指定任务序列的新名称。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PassThru

返回当前工作对象。 默认情况下,此 cmdlet 不生成任何输出。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ProgramName

指定要从 DeploymentPackageId 参数指定的 Configuration Manager 软件包运行的程序的名称。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RemoveSupportedOperatingSystemPlatform

从任务序列中删除受支持的操作系统平台对象。 若要获取支持的操作系统平台对象,请使用 Get-CMSupportedPlatform cmdlet。

类型:IResultObject[]
别名:RemoveSupportedOperatingSystemPlatforms
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RunAnotherProgram

指示是否在运行任务序列之前运行另一个程序。 使用 DeploymentPackageId 参数和 ProgramName 参数指定程序。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RunEveryTime

指示每次运行任务序列时, ProgramName 参数中指定的程序是否运行。 如果将值指定为 $False,则如果程序在过去成功运行,则程序不会运行。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RunOnAnyPlatform

指示任务序列在任何操作系统平台上运行。

类型:SwitchParameter
别名:ClearSupportedOperatingSystemPlatforms
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SuppressNotification

指示是否禁止显示此任务序列的通知。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-TaskSequenceId

指定任务序列的 ID。

类型:String
别名:Id, TaskSequencePackageId
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-TaskSequenceName

指定任务序列的名称。

类型:String
别名:Name
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-UseBootImage

指示任务序列是否使用 BootImageID 参数指定的启动映像。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UseDefaultText

指示在任务序列运行时是否使用进度通知对话框中的默认文本。 如果为此参数选择值 $False,请确保使用 CustomText 参数指定自定义文本。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示在 cmdlet 运行时发生的情况。 此 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object