New-CMSoftwareUpdatePhase
Используйте этот командлет, чтобы создать этап развертывания для обновления программного обеспечения.
Синтаксис
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
Этот параметр совпадает со следующим параметром на странице Скачивание параметровмастера добавления этапа в консоли: если обновления программного обеспечения недоступны в точке распространения в текущей, соседней группе или группе границ сайта, скачайте содержимое из Microsoft Обновления.
| Тип: | 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
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по