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