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


New-CMWindowsServicingPlan

Создает план обслуживания Windows 10.

Синтаксис

New-CMWindowsServicingPlan
   -Name <String>
   [-Description <String>]
   -CollectionName <String>
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Title <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMWindowsServicingPlan
   -Name <String>
   [-Description <String>]
   -Collection <IResultObject>
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Title <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMWindowsServicingPlan
   -Name <String>
   [-Description <String>]
   -CollectionId <String>
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Title <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет New-CMWindowsServicingPlan создает план обслуживания Windows 10.

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Создание плана обслуживания по идентификатору коллекции

PS XYZ:\> $Lang = ("Japanese", "English", "French")
PS XYZ:\> $Required = (">=1", "<=100")
PS XYZ:\> $Title = ("Title1", "Title2", "Title3")
PS XYZ:\> New-CMWindowsServicingPlan -Name "Test01" -CollectionId MP40001A -Description "Servicing Plan description01" -SendWakeupPacket $False -VerboseLevel AllMessages -Language $Lang -Required $Required -Title $Title -RunType DoNotRunThisRuleAutomatically -UseUtc $True -AvailableImmediately $True -DeadlineImmediately $False -UserNotification DisplayAll -AllowSoftwareInstallationOutsideMaintenanceWindow $True -AllowRestart $True -SuppressRestartServer $True -SuppressRestartWorkstation $True -DeploymentPackage (Get-CMSoftwareUpdateDeploymentPackage -Name "SUDP01")

Первая команда создает список языков и сохраняет его в переменной $Lang.

Вторая команда создает список строк поиска и сохраняет его в переменной $Required. Эта строка поиска найдет обновления программного обеспечения, необходимые по крайней мере на одном компьютере и не более 100 компьютеров.

Третья команда создает список заголовков обновлений программного обеспечения и сохраняет список в переменной $Title.

Последняя команда получает пакет развертывания обновлений программного обеспечения с именем SUDP01, а затем создает план обслуживания Windows с именем Test для целевой коллекции с идентификатором MP40001A. Команда добавляет языки фильтра обновления, хранящиеся в $Lang, необходимый фильтр, хранящийся в $Required, и фильтр заголовка обновления программного обеспечения, хранящийся в $Title.

Пример 2. Создание плана обслуживания по имени коллекции

PS XYZ:\> $LangSelect = ("Japanese", "English", "French", "German")
PS XYZ:\> New-CMWindowsServicingPlan -Name "Test02" -CollectionName "ColName02" -DeploymentPackage (Get-CMSoftwareUpdateDeploymentPackage -Name "SUP02") -WriteFilterHandling $True -GenerateSuccessAlert $True -SuccessPercentage $True -AlertTime 10 -AlertTimeUnit Days -DisableOperationManager $True -GenerateOperationManagerAlert $True -NoInstallOnRemote $True -NoInstallOnUnprotected $True -UseBranchCache $True -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True -DownloadFromInternet $True -Location "\\TestSevr\WSUSTemp" -DeploymentRing Cbb -UpdateDeploymentWaitDay 20 -LanguageSelection $LangSelect

Первая команда создает список языков выбора языка и сохраняет список в переменной $LangSelect.

Вторая команда получает пакет развертывания обновлений программного обеспечения с именем SUP02, а затем создает план обслуживания Windows с именем Test02 для целевой коллекции с именем ColName02. Команда добавляет язык выбора языков, хранящихся в $LangSelect.

Параметры

-AlertTime

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

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

-AlertTimeUnit

Задает единицу времени для параметра AlertTime . Допустимые значения:

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

-AllowRestart

Указывает, разрешена ли перезагрузка системы за пределами определенных периодов обслуживания при достижении крайнего срока установки.

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

-AllowSoftwareInstallationOutsideMaintenanceWindow

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

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

-AllowUseMeteredNetwork

Указывает, следует ли разрешить клиентам загружать содержимое через лимитное подключение к Интернету после крайнего срока, что может повлечь дополнительные расходы.

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

-AvailableImmediately

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

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

-AvailableTime

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

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

-AvailableTimeUnit

Указывает тип единицы времени для доступного времени программного обеспечения. Допустимые значения:

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

-Collection

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

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

-CollectionId

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

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

-CollectionName

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

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

-Confirm

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

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

-DeadlineImmediately

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

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

-DeadlineTime

Указывает количество единиц времени для крайнего срока.

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

-DeadlineTimeUnit

Указывает тип единицы времени для крайнего срока. Допустимые значения:

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

-DeploymentPackage

Указывает пакет развертывания обновлений программного обеспечения. Чтобы получить пакет развертывания обновлений программного обеспечения, используйте командлет Get-CMSoftwareUpdateDeploymentPackage .

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

-DeploymentRing

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

  • CB
  • Выпуск
  • BusinessMainstream
  • Cbb
  • Ltsb
Тип:DeploymentRing
Допустимые значения:CB, Release, BusinessMainstream, Cbb, Ltsb
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Description

Указывает описание плана обслуживания.

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

-DisableOperationManager

Указывает, следует ли отключать оповещения System Center Operations Manager во время обновлений программного обеспечения.

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

-DownloadFromInternet

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

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

-DownloadFromMicrosoftUpdate

Указывает, скачивают ли компьютеры содержимое из Центра обновления Майкрософт, если обновления программного обеспечения недоступны в предпочтительной точке распространения или удаленной точке распространения.

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

-Enable

Указывает, включен ли план обслуживания.

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

-GenerateOperationManagerAlert

Указывает, следует ли создавать оповещения Operations Manager во время обновления программного обеспечения.

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

-GenerateSuccessAlert

Указывает, следует ли создавать оповещение об успешном развертывании.

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

-Language

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

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

-LanguageSelection

Задает массив языков в виде строк. Компьютеры загружают обновления программного обеспечения, доступные на указанных языках, в дополнение к обновлениям, не зависящим от языка.

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

-Location

Указывает сетевое расположение, в котором находятся скачанные обновления.

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

-Name

Указывает имя плана обслуживания. Имя должно быть уникальным, чтобы описать цель правила и идентифицировать его у других пользователей на сайте Configuration Manager.

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

-NoInstallOnRemote

Указывает, следует ли разрешать установку обновлений в удаленных системах. Если указать значение $True, если клиент находится в пределах медленной или ненадежной границы сети или если клиент использует резервное исходное расположение для содержимого, Configuration Manager не устанавливает обновления программного обеспечения. Если указать значение $False, установка продолжается.

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

-NoInstallOnUnprotected

Указывает, следует ли разрешать установку обновлений в незащищенных системах. Если указать значение $True, если обновления программного обеспечения недоступны в каких-либо предпочтительных точках распространения, Configuration Manager не скачивает и не устанавливает обновления программного обеспечения. Если указать значение $False, установка продолжается.

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

-Required

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

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

-RunType

Указывает режим, в котором выполняется обновление. Допустимые значения:

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

-Schedule

Указывает время крайнего срока (из доступного времени развертывания). Чтобы создать расписание, используйте командлет New-CMSchedule .

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

-SendWakeupPacket

Указывает, следует ли отправлять пакет пробуждения компьютерам перед началом развертывания. Если это значение равно $True, Configuration Manager выводит компьютер из спящего режима. Если это значение равно $False, оно не выводит компьютеры из спящего режима. Для пробуждения компьютеров необходимо сначала настроить пробуждение по локальной сети.

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

-SuccessPercentage

Указывает процент соответствия клиентов в виде целого числа от 0 до 99. Если соответствие требованиям ниже этого процента, Configuration Manager создает необязательные оповещения.

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

-SuppressRestartServer

Указывает, подавляется ли перезапуск системы на серверах, когда обновление программного обеспечения требует перезагрузки системы для завершения процесса установки.

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

-SuppressRestartWorkstation

Указывает, подавляется ли перезапуск системы на рабочих станциях, когда обновление программного обеспечения требует перезагрузки системы для завершения процесса установки.

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

-Title

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

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

-UpdateDeploymentWaitDay

Указывает количество дней ожидания после публикации нового обновления корпорацией Майкрософт перед развертыванием в вашей среде.

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

-UseBranchCache

Указывает, следует ли использовать кэш ветвей. Если указать значение $True, клиенты совместно используют содержимое в одной подсети.

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

-UserNotification

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

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

-UseUtc

Указывает, оценивается ли расписание для этого развертывания на основе универсального скоординированного времени (UTC).

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

-VerboseLevel

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

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

-WhatIf

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

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

-WriteFilterHandling

Указывает, фиксируются ли изменения в крайнем сроке или во время периода обслуживания (требуется перезапуск). Если задано значение $False, содержимое применяется к наложению и фиксируется позже.

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

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

None

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

System.Object