Поделиться через


Set-CMTaskSequencePhase

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

Синтаксис

Set-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-Comments <String>]
   [-DeploymentOption <DeploymentOptionType>]
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-MovePhase <ReorderType>]
   [-MoveToOrder <Int32>]
   [-NewCollection <IResultObject>]
   [-NewCollectionId <String>]
   [-NewCollectionName <String>]
   [-NewPhaseName <String>]
   [-ThrottlingDays <Int32>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Id <String>]
   [-InputObject] <IResultObject>
   [-Name <String>]
   [-Order <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-Comments <String>]
   [-DeploymentOption <DeploymentOptionType>]
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-MovePhase <ReorderType>]
   [-MoveToOrder <Int32>]
   [-NewCollection <IResultObject>]
   [-NewCollectionId <String>]
   [-NewCollectionName <String>]
   [-NewPhaseName <String>]
   [-ThrottlingDays <Int32>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Id <String>]
   [-Name <String>]
   [-Order <Int32>]
   [-PhasedDeploymentId] <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-Comments <String>]
   [-DeploymentOption <DeploymentOptionType>]
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-MovePhase <ReorderType>]
   [-MoveToOrder <Int32>]
   [-NewCollection <IResultObject>]
   [-NewCollectionId <String>]
   [-NewCollectionName <String>]
   [-NewPhaseName <String>]
   [-ThrottlingDays <Int32>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Id <String>]
   [-Name <String>]
   [-Order <Int32>]
   [-PhasedDeploymentName] <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Применяется к версии 2006 и более поздним. Используйте этот командлет, чтобы настроить этап развертывания для последовательности задач. Дополнительные сведения см. в разделе Создание поэтапных развертываний.

Примеры

Пример 1. Изменение коллекции

В этом примере изменяется коллекция для второго этапа поэтапного развертывания последовательности задач, прошедшего в командной строке.

$phasedDeployment = Get-CMTaskSequencePhasedDeployment -Name "myPhasedDeployment"

$phasedDeployment | Set-CMTaskSequencePhase -Order 2 -NewCollectionId "XYZ00227"

Пример 2. Перемещение этапа вверх

В этом примере этап перемещается вверх по порядку. Он выбирает поэтапное развертывание по его идентификатору, а этап — по связанному идентификатору коллекции.

Set-CMTaskSequencePhase -PhasedDeploymentId "0bc464d9-e7dd-44c1-a157-3f8be6a79c03" -CollectionId "XYZ00227" -MovePhase MoveUp

Пример 3. Настройка параметров фазы

В этом примере изменяются параметры конфигурации для выбранного этапа.

Set-CMTaskSequencePhase -PhasedDeploymentName "myPhasedDeployment" -Name "phase1" -UserNotification HideAll -SoftwareInstallation $true -AllowSystemRestart $true -WriteFilterCommit $false -PreDownload $true -Comments "phase 1 comment" -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowRemoteDP $true -AllowFallback $false -CriteriaOption Compliance -CriteriaValue 90 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 3 -ThrottlingDays 5 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 12

Параметры

-AllowFallback

Этот параметр совпадает со следующим параметром на странице Точки распространениямастера добавления этапа в консоли: Разрешить клиентам использовать точки распространения из группы границ сайта по умолчанию.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AllowRemoteDP

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

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AllowSystemRestart

Этот параметр совпадает со следующим параметром на странице Взаимодействие с пользователеммастера добавления этапа в консоли: перезагрузка системы (если требуется для завершения установки). Этот параметр применяется по достижении крайнего срока установки, чтобы разрешить выполнение этого действия за пределами периода обслуживания.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-BeginCondition

Укажите параметр для начала этого этапа развертывания после успешного выполнения предыдущего этапа:

  • AfterPeriod: этот параметр совпадает со следующим параметром на странице Параметры фазымастера добавления этапов в консоли: автоматически начинается этот этап после периода отсрочки (в днях). Если указать это значение, используйте DaysAfterPreviousPhaseSuccess , чтобы настроить период времени.

  • Manually: этот параметр совпадает со следующим параметром на странице Параметры фазымастера добавления этапов в консоли: вручную начните этот этап развертывания.

Тип:BeginConditionType
Допустимые значения:AfterPeriod, Manually
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Collection

Указание объекта для целевой коллекции

Тип:IResultObject
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CollectionId

Укажите целевую коллекцию по идентификатору.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CollectionName

Укажите целевую коллекцию по имени.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Comments

Укажите необязательные примечания для этого этапа. Максимальная длина — 512 символов.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

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

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CriteriaOption

Укажите параметр для выбора критериев для успешного выполнения предыдущего этапа:

  • Compliance: этот параметр совпадает со следующим параметром на странице Параметры фазымастера добавления этапов в консоли: процент успешного развертывания. Укажите процентное значение с помощью параметра CriteriaValue .

  • Number: этот параметр совпадает со следующим параметром на странице Параметры фазымастера добавления фазы в консоли: Количество устройств, успешно развернутых. Укажите количество устройств с помощью параметра CriteriaValue .

Тип:CriteriaType
Допустимые значения:Compliance, Number
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CriteriaValue

Это целочисленное значение зависит от значения, указанного в параметре CriteriaOption:

  • Compliance: укажите процент.

  • Number: укажите количество устройств.

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DaysAfterPreviousPhaseSuccess

Укажите целочисленное значение для числа дней после успешного выполнения предыдущего этапа, чтобы начать этот этап. Этот параметр совпадает со следующим параметром на странице Параметры фазымастера добавления этапа в консоли: Автоматически начинается этот этап после периода отсрочки (в днях).

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DeadlineUnit

Укажите тип крайнего срока. Используйте этот параметр с DeadlineValue.

Тип:TimeUnitType
Допустимые значения:Hours, Days, Weeks, Months
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DeadlineValue

Этот параметр используется только при указании AfterPeriod с помощью параметра InstallationChoice .

Укажите целочисленное значение для периода времени для крайнего срока. Используйте параметр DeadlineUnit, чтобы указать тип точки: Hours, Days, Weeks, . Months Этот параметр совпадает со следующим параметром на странице Параметры фазымастера добавления фазы в консоли: установка требуется по истечении этого периода времени.

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DeploymentOption

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

  • DownloadContentLocallyWhenNeededByRunningTaskSequence: скачивание содержимого локально, если это необходимо для выполнения последовательности задач.
  • DownloadAllContentLocallyBeforeStartingTaskSequence: скачивание всего содержимого локально перед запуском последовательности задач
Тип:DeploymentOptionType
Допустимые значения:DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableWildcardHandling

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ForceWildcardHandling

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Id

Укажите идентификатор настраиваемого этапа.

Тип:String
Aliases:PhaseId
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InputObject

Укажите объект поэтапного развертывания, включающий этап настройки.

Тип:IResultObject
Aliases:PhasedDeployment
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-InstallationChoice

Укажите параметр для поведения относительно того, когда программное обеспечение становится доступным:

  • AsSoonAsPossible: этот параметр совпадает со следующим параметром на странице Параметры фазымастера добавления этапов в консоли: установка требуется как можно скорее.

  • AfterPeriod: этот параметр совпадает со следующим параметром на странице Параметры фазымастера добавления этапов в консоли: установка требуется по истечении этого периода времени. Если указать это значение, используйте DeadlineUnit и DeadlineValue , чтобы настроить период времени.

Тип:InstallationChoiceType
Допустимые значения:AsSoonAsPossible, AfterPeriod
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-MovePhase

Измените порядок выбранного этапа. Вы можете переместить его вверх, вниз или к определенному индексу. Если задано MoveToOrderзначение , используйте параметр -MoveToOrder , чтобы задать конкретный индекс.

Тип:ReorderType
Допустимые значения:MoveUp, MoveDown, MoveToOrder
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-MoveToOrder

Если для параметра -MovePhase задано значение MoveToOrder, используйте этот параметр, чтобы задать конкретный индекс.

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

Укажите имя настраиваемого этапа.

Тип:String
Aliases:PhaseName
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NewCollection

Укажите объект коллекции, который будет использоваться в качестве нового целевого объекта для выбранного этапа.

Тип:IResultObject
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NewCollectionId

Укажите коллекцию по идентификатору для использования в качестве нового целевого объекта для выбранного этапа.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NewCollectionName

Укажите коллекцию по имени для использования в качестве нового целевого объекта для выбранного этапа.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NewPhaseName

Используйте этот параметр для переименования выбранного этапа.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Order

Укажите индекс настраиваемого этапа.

Тип:Int32
Aliases:PhaseOrder
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PhasedDeploymentId

Выберите поэтапное развертывание по идентификатору. Затем используйте другие параметры, чтобы выбрать конкретный этап в этом развертывании.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PhasedDeploymentName

Выберите поэтапное развертывание по имени. Затем используйте другие параметры, чтобы выбрать конкретный этап в этом развертывании.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PreDownload

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

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SoftwareInstallation

Этот параметр совпадает со следующим параметром на странице Взаимодействие с пользователеммастера добавления этапа в консоли: Установка программного обеспечения. Этот параметр применяется по достижении крайнего срока установки, чтобы разрешить выполнение этого действия за пределами периода обслуживания.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ThrottlingDays

Укажите целочисленное значение для количества дней, чтобы постепенно сделать это программное обеспечение доступным. Этот параметр совпадает со следующим параметром на странице Параметры фазыв мастере добавления этапов в консоли: постепенно делайте это программное обеспечение доступным в течение этого периода времени (в днях).

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UserNotification

Этот параметр совпадает со следующим параметром на странице Взаимодействие с пользователеммастера добавления этапа в консоли: укажите параметр взаимодействия с пользователем для этого развертывания со следующими значениями:

  • DisplayAll: отображается в Центре программного обеспечения и отображаются все уведомления.
  • HideAll: скрытие в центре программного обеспечения и всех уведомлений
Тип:UserNotificationType
Допустимые значения:DisplayAll, HideAll
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WriteFilterCommit

Этот параметр совпадает со следующим параметром на странице Взаимодействие с пользователеммастера добавления этапа в консоли: Фиксация изменений в крайнем сроке или во время периода обслуживания (требуется перезагрузка). Этот параметр применяется к обработке фильтра записи для устройств Windows Embedded.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

IResultObject