Set-CMTaskSequence

  • Ссылка
Модуль:
ConfigurationManager

Задает последовательность задач 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 изменяет последовательность задач Configuration Manager.

Примечание.

Выполните командлеты Configuration Manager с диска сайта Configuration Manager, например 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 .

Type:IResultObject[]
Aliases:AddSupportedOperatingSystemPlatforms
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BootImageId

Указывает идентификатор загрузочного образа.

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

-Category

Задает категорию для последовательности задач. Категории можно использовать для группировки последовательностей задач.

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

-Confirm

Перед запуском командлет запросит подтверждение.

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

-CustomText

Задает пользовательский текст для последовательности задач. Пользовательский текст отображается в диалоговом окне уведомления о ходе выполнения во время выполнения последовательности задач.

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

-DeploymentPackageId

Указывает идентификатор пакета. Если указать значение $True для параметра RunAnotherProgram , указанный пакет выполняется перед выполнением последовательности задач.

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

-Description

Указывает описание последовательности задач.

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

-DisableTaskSequence

Указывает, следует ли отключить эту последовательность задач.

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

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

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

-EnableNotification

Указывает, следует ли включать уведомления для этой последовательности задач.

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

-EnableTaskSequence

Указывает, следует ли включить эту последовательность задач.

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

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

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

-HighPerformance

Используйте этот параметр, чтобы задать следующий параметр на странице Производительность свойств последовательности задач: Запуск от высокопроизводительного плана управления питанием.

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

-InputObject

Указывает объект последовательности задач. Чтобы получить объект последовательности задач, используйте командлет Get-CMTaskSequence .

Type:IResultObject
Aliases:TaskSequence
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaxRunTimeMins

Задает в минутах максимальное время выполнения последовательности задач.

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

-NewName

Задает новое имя для последовательности задач.

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

-PassThru

Возвращает текущий рабочий объект. По умолчанию данный командлет не создает каких-либо выходных результатов.

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

-ProgramName

Указывает имя программы, запускаемой из пакета программного обеспечения Configuration Manager, указанного параметром DeploymentPackageId.

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

-RemoveSupportedOperatingSystemPlatform

Удаляет поддерживаемый объект платформы операционной системы из последовательности задач. Чтобы получить поддерживаемый объект платформы операционной системы, используйте командлет Get-CMSupportedPlatform .

Type:IResultObject[]
Aliases:RemoveSupportedOperatingSystemPlatforms
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAnotherProgram

Указывает, следует ли запускать другую программу перед выполнением последовательности задач. Укажите программу с помощью параметров DeploymentPackageId и ProgramName .

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

-RunEveryTime

Указывает, выполняется ли программа, указанная в параметре ProgramName , при каждом запуске последовательности задач. Если указать значение $False, программа не запускается, если она успешно выполнялась в прошлом.

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

-RunOnAnyPlatform

Указывает, что последовательность задач выполняется на любой платформе операционной системы.

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

-SuppressNotification

Указывает, следует ли подавлять уведомления для этой последовательности задач.

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

-TaskSequenceId

Указывает идентификатор последовательности задач.

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

-TaskSequenceName

Задает имя последовательности задач.

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

-UseBootImage

Указывает, использует ли последовательность задач загрузочный образ, указанный с помощью параметра BootImageID .

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

-UseDefaultText

Указывает, следует ли использовать текст по умолчанию в диалоговом окне уведомления о ходе выполнения во время выполнения последовательности задач. Если для этого параметра выбрано значение $False, обязательно укажите пользовательский текст с помощью параметра CustomText .

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

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет при этом не запускается.

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

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

System.Object