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


New-CMSoftwareUpdateAutoDeploymentRule

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

Синтаксис

New-CMSoftwareUpdateAutoDeploymentRule
   [-AddToExistingSoftwareUpdateGroup <Boolean>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-AllowRestart <Boolean>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-Architecture <ArchitectureType[]>]
   [-ArticleId <String[]>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-BulletinId <String[]>]
   [-CMTag <CMTagTypes[]>]
   -Collection <IResultObject>
   [-ContentSize <String[]>]
   [-CustomSeverity <SeverityType[]>]
   [-DateReleasedOrRevised <DateReleasedOrRevisedType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-DeploymentPackage <IResultObject>]
   [-DeploymentPackageName <String>]
   [-DeploymentRing <DeploymentRing>]
   [-DeployWithoutLicense <Boolean>]
   [-Description <String>]
   [-DisableOperationManager <Boolean>]
   [-DownloadFromInternet <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-Enable <Boolean>]
   [-EnabledAfterCreate <Boolean>]
   [-GenerateFailureAlert <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-IsServicingPlan]
   [-Language <String[]>]
   [-LanguageSelection <String[]>]
   [-Location <String>]
   [-MicrosoftAsVendor <Boolean>]
   -Name <String>
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-O365LanguageSelection <String[]>]
   [-Product <String[]>]
   [-Required <String[]>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-SendWakeupPacket <Boolean>]
   [-Severity <SeverityType[]>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SuccessPercentage <Int32>]
   [-Superseded <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-Title <String[]>]
   [-UpdateClassification <String[]>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-UpdateDescription <String[]>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-UseUtc <Boolean>]
   [-Vendor <String[]>]
   [-VerboseLevel <VerboseLevelType>]
   [-WriteFilterHandling <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateAutoDeploymentRule
   [-AddToExistingSoftwareUpdateGroup <Boolean>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-AllowRestart <Boolean>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-Architecture <ArchitectureType[]>]
   [-ArticleId <String[]>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-BulletinId <String[]>]
   [-CMTag <CMTagTypes[]>]
   -CollectionId <String>
   [-ContentSize <String[]>]
   [-CustomSeverity <SeverityType[]>]
   [-DateReleasedOrRevised <DateReleasedOrRevisedType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-DeploymentPackage <IResultObject>]
   [-DeploymentPackageName <String>]
   [-DeploymentRing <DeploymentRing>]
   [-DeployWithoutLicense <Boolean>]
   [-Description <String>]
   [-DisableOperationManager <Boolean>]
   [-DownloadFromInternet <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-Enable <Boolean>]
   [-EnabledAfterCreate <Boolean>]
   [-GenerateFailureAlert <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-IsServicingPlan]
   [-Language <String[]>]
   [-LanguageSelection <String[]>]
   [-Location <String>]
   [-MicrosoftAsVendor <Boolean>]
   -Name <String>
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-O365LanguageSelection <String[]>]
   [-Product <String[]>]
   [-Required <String[]>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-SendWakeupPacket <Boolean>]
   [-Severity <SeverityType[]>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SuccessPercentage <Int32>]
   [-Superseded <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-Title <String[]>]
   [-UpdateClassification <String[]>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-UpdateDescription <String[]>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-UseUtc <Boolean>]
   [-Vendor <String[]>]
   [-VerboseLevel <VerboseLevelType>]
   [-WriteFilterHandling <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateAutoDeploymentRule
   [-AddToExistingSoftwareUpdateGroup <Boolean>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-AllowRestart <Boolean>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-Architecture <ArchitectureType[]>]
   [-ArticleId <String[]>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-BulletinId <String[]>]
   [-CMTag <CMTagTypes[]>]
   -CollectionName <String>
   [-ContentSize <String[]>]
   [-CustomSeverity <SeverityType[]>]
   [-DateReleasedOrRevised <DateReleasedOrRevisedType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-DeploymentPackage <IResultObject>]
   [-DeploymentPackageName <String>]
   [-DeploymentRing <DeploymentRing>]
   [-DeployWithoutLicense <Boolean>]
   [-Description <String>]
   [-DisableOperationManager <Boolean>]
   [-DownloadFromInternet <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-Enable <Boolean>]
   [-EnabledAfterCreate <Boolean>]
   [-GenerateFailureAlert <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-IsServicingPlan]
   [-Language <String[]>]
   [-LanguageSelection <String[]>]
   [-Location <String>]
   [-MicrosoftAsVendor <Boolean>]
   -Name <String>
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-O365LanguageSelection <String[]>]
   [-Product <String[]>]
   [-Required <String[]>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-SendWakeupPacket <Boolean>]
   [-Severity <SeverityType[]>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SuccessPercentage <Int32>]
   [-Superseded <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-Title <String[]>]
   [-UpdateClassification <String[]>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-UpdateDescription <String[]>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-UseUtc <Boolean>]
   [-Vendor <String[]>]
   [-VerboseLevel <VerboseLevelType>]
   [-WriteFilterHandling <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет New-CMSoftwareUpdateAutoDeploymentRule создает правило автоматического развертывания (ADR) для обновлений программного обеспечения. При выполнении правила Configuration Manager добавляет обновления, соответствующие правилу, в группу обновлений программного обеспечения. Сервер Configuration Manager загружает файлы содержимого и копирует их в точки распространения, а затем обновляет клиентские компьютеры. Дополнительные сведения см. в статье Автоматическое развертывание обновлений программного обеспечения.

Примечание.

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

Примеры

Пример 1. Создание простого ADR

Эта команда создает правило развертывания с именем DeploymentRule07 для коллекции Desktops и пакета развертывания Updates123. Правило развертывает обновления с идентификатором статьи, содержащей 117.

New-CMSoftwareUpdateAutoDeploymentRule -CollectionName "Desktops" -DeploymentPackageName "Updates123" -Name "DeploymentRule07" -ArticleId "117"

Пример 2. Создание ADR, использующего расписание и другие свойства

В этом примере создается правило автоматического развертывания, использующее определенное расписание. Развертывание выполняется в соответствии с расписанием.

Первая команда создает расписание для среды и сохраняет объект schedule в переменной $Schedule . Дополнительные сведения см. в разделе New-CMSchedule.

Вторая команда создает правило автоматического развертывания для обновлений, в котором используется объект schedule, хранящийся в переменной. Эта команда задает значения для многих параметров.

$Schedule = New-CMSchedule -DayOfWeek Wednesday

New-CMSoftwareUpdateAutoDeploymentRule -CollectionName "Laptops" -DeploymentPackageName "Updates235" -Name "DeploymentRule22" -AddToExistingSoftwareUpdateGroup $False -AlertTime 4 -AlertTimeUnit Weeks -AllowRestart $True -AllowSoftwareInstallationOutsideMaintenanceWindow $True -AllowUseMeteredNetwork $True -ArticleId "test" -AvailableImmediately $False -AvailableTime 5 -AvailableTimeUnit Months -CustomSeverity Critical -DateReleasedOrRevised Last1day -DeadlineImmediately $False -DeadlineTime $True -DeadlineTimeUnit Hours -DeployWithoutLicense $True -Description "Standard updates for our laptop systems." -DisableOperationManager $True -DownloadFromInternet $False -DownloadFromMicrosoftUpdate $True -EnabledAfterCreate $False -GenerateOperationManagerAlert $True -GenerateSuccessAlert $True -Location "\\k\aS_O15_Client_Dev_1" -NoInstallOnRemote $False -NoInstallOnUnprotected $True -RunType RunTheRuleOnSchedule -Schedule $Schedule -SendWakeUpPacket $True -SuccessPercent 99 -Superseded $True -SuppressRestartServer $True -SuppressRestartWorkstation $True -UpdateClassification "Critical Updates" -UseBranchCache $False -UserNotification DisplayAll -UseUtc $True -VerboseLevel AllMessages -WriteFilterHandling $True

Пример 3. Создание ADR для нескольких языков

В этом примере создается ADR, который добавляет языковые критерии для трех языков: английского, венгерского и китайского (упрощенное письмо, PRC). Он также добавляет эти языки для двоичных файлов обновления Windows и Office 365 для скачивания. Этот пример правила отключен по умолчанию.

New-CMSoftwareUpdateAutoDeploymentRule -Name "Multi-language ADR" -CollectionId "XYZ0003F" -Language "English","Hungarian","Chinese (Simplified, PRC)" -Enable $false -EnabledAfterCreate $false -RunType DoNotRunThisRuleAutomatically -LanguageSelection "English","Hungarian","Chinese (Simplified, PRC)" -O365LanguageSelection "English (United States)","Hungarian (Hungary)","Chinese (Simplified, PRC)"

Параметры

-AddToExistingSoftwareUpdateGroup

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

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

Укажите существующую группу обновлений или назначьте имя новой группы обновлений с помощью параметра -DeploymentPackageName .

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

-AlertTime

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

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

-AlertTimeUnit

Задает единицу времени для параметра -AlertTime .

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

-AllowRestart

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

  • Если это значение равно $True, Configuration Manager при необходимости перезагрузит компьютер, чтобы завершить обновление.
  • Если это значение равно $False, Configuration Manager не перезагрузит компьютер.
Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AllowSoftwareInstallationOutsideMaintenanceWindow

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

  • Если это значение равно $True, Configuration Manager развертывает обновление, даже если запланированное время выходит за пределы окна службы.
  • Если это значение равно $False, Configuration Manager не развертывает обновление за пределами окна службы. Он ожидает развертывания в окне службы.
Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AllowUseMeteredNetwork

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

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

-Architecture

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

Тип:ArchitectureType[]
Aliases:Architectures
Допустимые значения:Arm64, Itanium, X64, X86
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ArticleId

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

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

-AvailableImmediately

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

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

-AvailableTime

Задает период времени в виде целого числа. Configuration Manager развертывает обновления в течение длительного времени после выполнения правила. Укажите единицу времени с помощью параметра -AvailableTimeUnit .

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

-AvailableTimeUnit

Задает единицу времени для параметра -AvailableTime .

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

-BulletinId

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

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

-CMTag

Это свойство зарезервировано для использования в будущем.

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

-Collection

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

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

-ContentSize

Используйте этот параметр, чтобы задать фильтр свойств Размер содержимого (КБ) на странице Обновления программного обеспечения свойств ADR.

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

-CustomSeverity

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

Тип:SeverityType[]
Допустимые значения:None, Low, Moderate, Important, Critical
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DateReleasedOrRevised

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

Тип:DateReleasedOrRevisedType
Допустимые значения:Any, Last1Hour, LastHour, Last2Hours, Last3Hours, Last4Hours, Last8Hours, Last12Hours, Last16Hours, Last20Hours, Last1Day, LastDay, Last2Days, Last3Days, Last4Days, Last5Days, Last6Days, Last7Days, Last14Days, Last21Days, Last28Days, LastMonth, Last1Month, Last2Months, Last3Months, Last4Months, Last5Months, Last6Months, Last7Months, Last8Months, Last9Months, Last10Months, Last11Months, Last1Year, LastYear, Last12Months
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DeadlineImmediately

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

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

-DeadlineTime

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

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

-DeadlineTimeUnit

Задает единицу времени для параметра -DeadlineTime .

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

-DeploymentPackage

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

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

-DeploymentPackageName

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

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

-DeploymentRing

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

-DeployWithoutLicense

Указывает, развертывает ли правило обновления без лицензий.

  • Если указать значение $True, Configuration Manager развертывает все обновления для этого правила и утверждает все лицензионные соглашения.
  • Если это значение равно $False, Configuration Manager развертывает только обновления, не включающие лицензию или для которых было утверждено лицензионное соглашение.
Тип:Boolean
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

-DisableWildcardHandling

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

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

-DownloadFromInternet

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

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

-EnabledAfterCreate

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

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

-ForceWildcardHandling

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

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

-GenerateFailureAlert

Если правило завершается ошибкой, создайте оповещение Configuration Manager.

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

-IsServicingPlan

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

-Language

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

Используйте формат языка, отображаемого в консоли. Например:

  • English
  • Hungarian
  • Chinese (Simplified, PRC)

Формат массива строк: "English","Hungarian","Chinese (Simplified, PRC)"

Совет

При выполнении этого командлета на компьютере с локализованным пользовательским интерфейсом Windows имена языков могут отличаться. Например, в английской версии Windows используется "датский", а в датской версии Windows используется "Dansk".

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

-LanguageSelection

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

Используйте формат языка, отображаемого в консоли. Например:

  • English
  • Hungarian
  • Chinese (Simplified, PRC)

Формат массива строк: "English","Hungarian","Chinese (Simplified, PRC)"

Совет

При выполнении этого командлета на компьютере с локализованным пользовательским интерфейсом Windows имена языков могут отличаться. Например, в английской версии Windows используется "датский", а в датской версии Windows используется "Dansk".

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

-Location

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

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

-MicrosoftAsVendor

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

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

-Name

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

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

-O365LanguageSelection

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

Используйте формат языка, отображаемый в консоли для выбора языка Центра обновления Windows . Этот формат совпадает с параметром LanguageSelection . Например:

  • English
  • Hungarian
  • Chinese (Simplified, PRC)

Формат массива строк: "English","Hungarian","Chinese (Simplified, PRC)"

Совет

При выполнении этого командлета на компьютере с локализованным пользовательским интерфейсом Windows имена языков могут отличаться. Например, в английской версии Windows используется "датский", а в датской версии Windows используется "Dansk".

В настоящее время с помощью этого параметра нельзя указать все языки, доступные в консоли Configuration Manager. Например, нельзя указать "Ирландский (Ирландия)" или "Мальтийский (Мальта)".

Начиная с версии 2103, необходимо указать язык с именем страны или региона. Это изменение сопоставляет этот параметр с параметрами в консоли Configuration Manager. Пример: -O365LanguageSelection "English (United States)"

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

-Product

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

Начиная с версии 2107, при наличии нескольких продуктов с одинаковым именем они выбираются.

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

-Required

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

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

-RequirePostRebootFullScan

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

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

-RunType

Укажите повторяющееся расписание, когда сайт оценивает ADR.

Если задано RunTheRuleOnScheduleзначение , укажите расписание с помощью параметра -Schedule .

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

-Schedule

Указывает объект расписания для развертывания. Чтобы получить объект schedule, используйте командлет New-CMSchedule . Укажите расписание для этого параметра, если задано RunTheRuleOnSchedule значение для параметра -RunType .

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

-SendWakeupPacket

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

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

Для пробуждения компьютеров необходимо сначала настроить пробуждение по локальной сети.

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

-Severity

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

Тип:SeverityType[]
Aliases:Severities
Допустимые значения:None, Low, Moderate, Important, Critical
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SoftDeadlineEnabled

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

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

-SuccessPercentage

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

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

-Superseded

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

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

-UpdateClassification

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

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

-UpdateDeploymentWaitDay

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

-UpdateDescription

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

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

-UseBranchCache

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

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

-UserNotification

Указывает тип уведомления пользователя.

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

-UseUtc

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

  • Если это значение равно $True, Configuration Manager использует utc для этого развертывания.
  • Если это значение равно $False, Configuration Manager использует местное время.
Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Vendor

Тип:String[]
Aliases:Vendors
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

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

  • Для значения $Trueустройство фиксирует изменения во время периода обслуживания. Для этого действия требуется перезагрузка.
  • Для значения $Falseустройство сохраняет изменения в наложении и фиксирует их позже.
Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

IResultObject

Примечания

Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе SMS_AutoDeployment класс WMI сервера.