New-CMSoftwareUpdatePhase

Модуль:

ConfigurationManager

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

Синтаксис

New-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-Collection] <IResultObject>
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InstallationChoice <InstallationChoiceType>]
   [-PhaseDescription <String>]
   -PhaseName <String>
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-ThrottlingDays <Int32>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionId] <String>
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InstallationChoice <InstallationChoiceType>]
   [-PhaseDescription <String>]
   -PhaseName <String>
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-ThrottlingDays <Int32>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionName] <String>
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InstallationChoice <InstallationChoiceType>]
   [-PhaseDescription <String>]
   -PhaseName <String>
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-ThrottlingDays <Int32>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

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

Примеры

Пример 1. Создание этапа обновления программного обеспечения

В этом примере создается этап обновления программного обеспечения с именем MySUPhase для коллекции MyCollection , которая будет отображаться только в Центре программного обеспечения.

New-CMSoftwareUpdatePhase `
 -CollectionName "MyCollection" `
 -PhaseName "MySUPhase" `
 -UserNotificationOption DisplaySoftwareCenterOnly

Параметры

-AlertDelta

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

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

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

-AlertThresholdPercentage

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

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

-AlertUnit

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

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

-AllowMeteredConnection

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

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

-AllowSystemRestart

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

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

-AllowWumuFallback

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

Тип:	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:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CollectionId

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

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

-CollectionName

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

Тип:	String
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	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

-DisableScomAlert

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

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

-DisableWildcardHandling

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

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

-EnableAlert

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

• AlertThresholdPercentage
• AlertDelta

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

-EnableWakeOnLan

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

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

-ForceWildcardHandling

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

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

-GenerateScomAlertOnFailure

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

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

-InstallationChoice

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

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

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

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

-PhaseDescription

Укажите описание этапа.

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

-PhaseName

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

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

-RequirePostRebootFullScan

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

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

-ServerRestartSuppression

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

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

-SoftwareInstallation

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

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

-StateMessageVerbosity

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

• AllMessages: все сообщения
• OnlySuccessAndErrorMessages: только сообщения об успешном выполнении и ошибках
• OnlyErrorMessages: только сообщения об ошибках

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

-ThrottlingDays

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

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

-UseNeighborDP

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

• $true: скачивание обновлений программного обеспечения из точки распространения и установка
• $false: не устанавливайте обновления программного обеспечения.

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

-UserNotificationOption

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

• DisplayAll: отображается в Центре программного обеспечения и отображаются все уведомления.
• DisplaySoftwareCenterOnly: отображается в центре программного обеспечения и отображаются только уведомления о перезагрузке компьютера.
• HideAll: скрытие в центре программного обеспечения и всех уведомлений

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

-UseSiteDefaultDP

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

• $true: скачивание и установка обновлений программного обеспечения из точек распространения в группе границ сайта по умолчанию
• $false: не устанавливайте обновления программного обеспечения.

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

-WhatIf

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

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

-WorkstationRestartSuppression

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

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

-WriteFilterCommit

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

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

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

None

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

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase