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. Перемещение этапа вверх

Этот пример перемещает этап вверх в порядке. Он выбирает поэтапное развертывание по своему ID и выбирает этап по связанному с ним ИД коллекции.

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

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

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

-AllowRemoteDP

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

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

-AllowSystemRestart

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

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

-BeginCondition

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

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

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

Type:BeginConditionType
Accepted values:AfterPeriod, Manually
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Collection

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

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

-CollectionId

Укажите целевой набор по ID.

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

-CollectionName

Укажите целевой набор по имени.

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

-Comments

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

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

-Confirm

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

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

-CriteriaOption

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

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

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

Type:CriteriaType
Accepted values:Compliance, Number
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CriteriaValue

Это значение зависит от значения, которое вы указываете для CriteriaOption:

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

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

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

-DaysAfterPreviousPhaseSuccess

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

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

-DeadlineUnit

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

Type:TimeUnitType
Accepted values:Hours, Days, Weeks, Months
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeadlineValue

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

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

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

-DeploymentOption

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

  • DownloadContentLocallyWhenNeededByRunningTaskSequence: Загрузка контента локально при необходимости по последовательности запущенных задач
  • DownloadAllContentLocallyBeforeStartingTaskSequence: Скачайте все содержимое локально перед началом последовательности задач
Type:DeploymentOptionType
Accepted values:DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-Id

Укажите ID фазы для настройки.

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

-InputObject

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

Type:IResultObject
Aliases:PhasedDeployment
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-InstallationChoice

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

  • AsSoonAsPossible. Этот параметр такой же, как и следующий параметр на **** странице Phase Параметры мастера фазы добавления в консоли. Установка требуется как можно скорее.

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

Type:InstallationChoiceType
Accepted values:AsSoonAsPossible, AfterPeriod
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MovePhase

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

Type:ReorderType
Accepted values:MoveUp, MoveDown, MoveToOrder
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MoveToOrder

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

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

-Name

Укажите имя этапа для настройки.

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

-NewCollection

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

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

-NewCollectionId

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

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

-NewCollectionName

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

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

-NewPhaseName

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

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

-Order

Укажите индекс фазы для настройки.

Type:Int32
Aliases:PhaseOrder
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PhasedDeploymentId

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

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

-PhasedDeploymentName

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

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

-PreDownload

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

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

-SoftwareInstallation

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

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

-ThrottlingDays

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

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

-UserNotification

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

  • DisplayAll: Отображение в Центре программного обеспечения и отображение всех уведомлений
  • HideAll: Скрыть в Центре программного обеспечения и все уведомления
Type:UserNotificationType
Accepted values:DisplayAll, HideAll
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

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

-WriteFilterCommit

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

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

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

IResultObject