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 изменяет последовательность задач 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 .
Тип: | IResultObject[] |
Aliases: | AddSupportedOperatingSystemPlatforms |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-BootImageId
Указывает идентификатор загрузочного образа.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Category
Задает категорию для последовательности задач. Категории можно использовать для группировки последовательностей задач.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Confirm
Перед запуском командлет запросит подтверждение.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-CustomText
Задает пользовательский текст для последовательности задач. Пользовательский текст отображается в диалоговом окне уведомления о ходе выполнения во время выполнения последовательности задач.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DeploymentPackageId
Указывает идентификатор пакета. Если указать значение $True для параметра RunAnotherProgram , указанный пакет выполняется перед выполнением последовательности задач.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Description
Указывает описание последовательности задач.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DisableTaskSequence
Указывает, следует ли отключить эту последовательность задач.
Тип: | Boolean |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DisableWildcardHandling
Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-EnableNotification
Указывает, следует ли включать уведомления для этой последовательности задач.
Тип: | Boolean |
Aliases: | EnableNotifications |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-EnableTaskSequence
Указывает, следует ли включить эту последовательность задач.
Тип: | Boolean |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ForceWildcardHandling
Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-HighPerformance
Используйте этот параметр, чтобы задать следующий параметр на странице Производительность свойств последовательности задач: Запустить как высокопроизводительный план управления питанием.
Тип: | Boolean |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-InputObject
Указывает объект последовательности задач. Чтобы получить объект последовательности задач, используйте командлет Get-CMTaskSequence .
Тип: | IResultObject |
Aliases: | TaskSequence |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-MaxRunTimeMins
Задает в минутах максимальное время выполнения последовательности задач.
Тип: | Int64 |
Aliases: | Duration |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-NewName
Задает новое имя для последовательности задач.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-PassThru
Возвращает текущий рабочий объект. По умолчанию данный командлет не создает каких-либо выходных результатов.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ProgramName
Указывает имя программы, запускаемой из пакета программного обеспечения Configuration Manager, указанного параметром DeploymentPackageId .
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-RemoveSupportedOperatingSystemPlatform
Удаляет поддерживаемый объект платформы операционной системы из последовательности задач. Чтобы получить поддерживаемый объект платформы операционной системы, используйте командлет Get-CMSupportedPlatform .
Тип: | IResultObject[] |
Aliases: | RemoveSupportedOperatingSystemPlatforms |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-RunAnotherProgram
Указывает, следует ли запускать другую программу перед выполнением последовательности задач. Укажите программу с помощью параметров DeploymentPackageId и ProgramName .
Тип: | Boolean |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-RunEveryTime
Указывает, выполняется ли программа, указанная в параметре ProgramName , при каждом запуске последовательности задач. Если указать значение $False, программа не запускается, если она успешно выполнялась в прошлом.
Тип: | Boolean |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-RunOnAnyPlatform
Указывает, что последовательность задач выполняется на любой платформе операционной системы.
Тип: | SwitchParameter |
Aliases: | ClearSupportedOperatingSystemPlatforms |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-SuppressNotification
Указывает, следует ли подавлять уведомления для этой последовательности задач.
Тип: | Boolean |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-TaskSequenceId
Указывает идентификатор последовательности задач.
Тип: | String |
Aliases: | Id, TaskSequencePackageId |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-TaskSequenceName
Задает имя последовательности задач.
Тип: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-UseBootImage
Указывает, использует ли последовательность задач загрузочный образ, указанный с помощью параметра BootImageID .
Тип: | Boolean |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-UseDefaultText
Указывает, следует ли использовать текст по умолчанию в диалоговом окне уведомления о ходе выполнения во время выполнения последовательности задач. Если для этого параметра выбрано значение $False, обязательно укажите пользовательский текст с помощью параметра CustomText .
Тип: | Boolean |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Командлет при этом не запускается.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Выходные данные
System.Object