New-CMAutoDeploymentRuleDeployment

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

Синтаксис

New-CMAutoDeploymentRuleDeployment
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-AllowDownloadFromMicrosoftUpdate <Boolean>]
   [-AllowRestart <Boolean>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-DisableOperationsManager <Boolean>]
   [-EnableDeployment <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-Name] <String>
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SuccessPercentage <Int32>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationOption>]
   [-UseUtc <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-WriteFilterHandling <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMAutoDeploymentRuleDeployment
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-AllowDownloadFromMicrosoftUpdate <Boolean>]
   [-AllowRestart <Boolean>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-DisableOperationsManager <Boolean>]
   [-EnableDeployment <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-Id] <Int32>
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SuccessPercentage <Int32>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationOption>]
   [-UseUtc <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-WriteFilterHandling <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMAutoDeploymentRuleDeployment
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-AllowDownloadFromMicrosoftUpdate <Boolean>]
   [-AllowRestart <Boolean>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-DisableOperationsManager <Boolean>]
   [-EnableDeployment <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-InputObject] <IResultObject>
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SuccessPercentage <Int32>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationOption>]
   [-UseUtc <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-WriteFilterHandling <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет New-CMAutoDeploymentRuleDeployment создает развертывание для правила автоматического развертывания (ADR).

Примечание.

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

Примеры

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

Эта команда создает развертывание для правила автоматического развертывания TestDepRule01 и коллекции All Systems .

New-CMAutoDeploymentRuleDeployment -Name "TestDepRule01" -CollectionName "All Systems" -EnableDeployment $true -SendWakeupPacket $false -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $false  -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $false -AllowRestart $false -SuppressRestartServer  $false -SuppressRestartWorkstation $false -WriteFilterHandling $false -GenerateSuccessAlert $true -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $false -GenerateOperationsManagerAlert $false -NoInstallOnRemote $false -NoInstallOnUnprotected $false -UseBranchCache $false

Пример 2. Создание развертывания для правила автоматического развертывания по объекту

Эта команда возвращает объект правила автоматического развертывания с именем TestDepRule02. Затем он использует оператор конвейера для передачи объекта в New-CMAutoDeploymentRuleDeployment, который создает развертывание для правила автоматического развертывания TestDepRule02 и коллекции All Systems .

Get-CMAutoDeploymentRule -Name "TestDepRule02" | New-CMAutoDeploymentRuleDeployment -CollectionName "All Systems" -EnableDeployment $true -SendWakeupPacket $false -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $false -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $false -AllowRestart $false -SuppressRestartServer $false -SuppressRestartWorkstation $false -WriteFilterHandling $false -GenerateSuccessAlert  $true -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $false -GenerateOperationsManagerAlert $false -NoInstallOnRemote $false -NoInstallOnUnprotected $false -UseBranchCache $false

Параметры

-AlertTime

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

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

-AlertTimeUnit

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

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

-AllowDownloadFromMicrosoftUpdate

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

Тип:Boolean
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

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

Тип: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

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

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

-Collection

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

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

-CollectionId

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

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

-CollectionName

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

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

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

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

-DisableOperationsManager

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

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

-DisableWildcardHandling

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

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

-EnableDeployment

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

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

-ForceWildcardHandling

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

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

-GenerateOperationsManagerAlert

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

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

-GenerateSuccessAlert

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

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

-Id

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

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

-InputObject

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

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

-Name

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

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

-NoInstallOnRemote

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

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

-NoInstallOnUnprotected

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

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

-RequirePostRebootFullScan

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

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

-SendWakeupPacket

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

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

-SoftDeadlineEnabled

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

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

-SuccessPercentage

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

Тип: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

-UseBranchCache

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

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

-UserNotification

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

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

-UseUtc

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

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

-VerboseLevel

Указывает, сколько сведений о состоянии клиенты возвращают для развертываний, созданных этим правилом.

Тип: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

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

IResultObject