Set-CMSoftwareUpdatePhase

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

Синтаксис

Set-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-PhaseDescription <String>]
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-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-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-PhaseDescription <String>]
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-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-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-PhaseDescription <String>]
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-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-CMSoftwareUpdatePhasedDeployment -Name "myPhasedDeployment"

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

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

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

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

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

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

Set-CMSoftwareUpdatePhase -PhasedDeploymentName "myPhasedDeployment" -Name "phase1" -UserNotification HideAll -SoftwareInstallation $true -AllowSystemRestart $true -WriteFilterCommit $false -EnableWakeOnLan $true -PhaseDescription "this is phase 1" -StateMessageVerbosity AllMessages -ServerRestartSuppression $true -WorkstationRestartSuppression $true -RequirePostRebootFullScan $true -EnableAlert $true -AlertThresholdPercentage 90 -AlertDelta 12 -AlertUnit Hours -DisableSCOMAlert $true -GenerateSCOMAlertOnFailure $true -UseNeighborDP $true -UseSiteDefaultDP $true -AllowWUMUFallback $true -AllowMeteredConnection $true -CriteriaOption Compliance -CriteriaValue 90 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 3 -ThrottlingDays 5 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 12

Параметры

-AlertDelta

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

Чтобы установить это значение, необходимо использовать параметр EnableAlert.

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

-AlertThresholdPercentage

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

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

-AlertUnit

Укажите тип периода. Используйте этот параметр с помощью AlertDelta.

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

-AllowMeteredConnection

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

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

-AllowWumuFallback

Этот параметр такой же, как и следующий параметр на **** странице Загрузка Параметры мастера фазы добавления в консоли. Если обновления программного обеспечения недоступны в точке распространения в текущих, соседских или пограничных группах сайта, скачайте содержимое из Microsoft Updates.

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

-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

-DisableScomAlert

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

Type:Boolean
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

-EnableAlert

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

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

-EnableWakeOnLan

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

Type:Boolean
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

-GenerateScomAlertOnFailure

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

Type:Boolean
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

-PhaseDescription

Укажите описание фазы.

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

-RequirePostRebootFullScan

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

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

-ServerRestartSuppression

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

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

-StateMessageVerbosity

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

  • AllMessages: Все сообщения
  • OnlySuccessAndErrorMessages: Только сообщения об успехах и ошибках
  • OnlyErrorMessages: Только сообщения об ошибках
Type:VerbosityLevelType
Accepted values:AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages
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

-UseNeighborDP

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

  • $true: Скачайте обновления программного обеспечения из точки распространения и установите
  • $false: Не устанавливайте обновления программного обеспечения
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UserNotificationOption

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

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

-UseSiteDefaultDP

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

  • $true: Скачивание и установка обновлений программного обеспечения из точек распространения в пограничной группе по умолчанию сайта
  • $false: Не устанавливайте обновления программного обеспечения
Type:Boolean
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

-WorkstationRestartSuppression

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

Type:Boolean
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