New-CMWindowsServicingPlan

Ссылка

Модуль:: ConfigurationManager

Создает план обслуживания 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

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