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


Set-CMClientSettingSoftwareUpdate

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

Синтаксис

Set-CMClientSettingSoftwareUpdate
   [-BatchingTimeout <Int32>]
   [-DeltaDownloadPort <Int32>]
   [-DeploymentEvaluationSchedule <IResultObject>]
   [-Enable <Boolean>]
   [-EnableDeltaDownload <Boolean>]
   [-EnableDynamicUpdate <Boolean>]
   [-EnableInstallation <Boolean>]
   [-EnableThirdPartyUpdates <Boolean>]
   [-EnableWsusCertPinning <Boolean>]
   [-EnforceMandatory <Boolean>]
   [-Office365ManagementType <Boolean>]
   [-ScanSchedule <IResultObject>]
   [-ThreadPriority <ThreadPriorityType>]
   [-TimeUnit <BatchingTimeoutType>]
   -Name <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMClientSettingSoftwareUpdate
   [-BatchingTimeout <Int32>]
   [-DeltaDownloadPort <Int32>]
   [-DeploymentEvaluationSchedule <IResultObject>]
   [-Enable <Boolean>]
   [-EnableDeltaDownload <Boolean>]
   [-EnableDynamicUpdate <Boolean>]
   [-EnableInstallation <Boolean>]
   [-EnableThirdPartyUpdates <Boolean>]
   [-EnableWsusCertPinning <Boolean>]
   [-EnforceMandatory <Boolean>]
   [-Office365ManagementType <Boolean>]
   [-ScanSchedule <IResultObject>]
   [-ThreadPriority <ThreadPriorityType>]
   [-TimeUnit <BatchingTimeoutType>]
   [-DefaultSetting]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMClientSettingSoftwareUpdate
   [-BatchingTimeout <Int32>]
   [-DeltaDownloadPort <Int32>]
   [-DeploymentEvaluationSchedule <IResultObject>]
   [-Enable <Boolean>]
   [-EnableDeltaDownload <Boolean>]
   [-EnableDynamicUpdate <Boolean>]
   [-EnableInstallation <Boolean>]
   [-EnableThirdPartyUpdates <Boolean>]
   [-EnableWsusCertPinning <Boolean>]
   [-EnforceMandatory <Boolean>]
   [-Office365ManagementType <Boolean>]
   [-ScanSchedule <IResultObject>]
   [-ThreadPriority <ThreadPriorityType>]
   [-TimeUnit <BatchingTimeoutType>]
   -InputObject <IResultObject>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Используйте этот командлет для настройки параметров в группе Обновления программного обеспечения параметров клиента. Дополнительные сведения см. в разделе Сведения о параметрах клиента: обновления программного обеспечения.

Примечание.

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

Примеры

Пример 1. Включение сторонних обновлений в параметрах клиента по умолчанию

Set-CMClientSettingSoftwareUpdate -DefaultSetting -Enable $true -EnableThirdPartyUpdates $true

Пример 2. Включение сторонних обновлений в настраиваемом параметре устройства

$clientDeviceSettingName = "Dev device settings"
Set-CMClientSettingSoftwareUpdate -Name $clientDeviceSettingName -Enable $true -EnableThirdPartyUpdates $true

Пример 3. Настройка нескольких параметров

Set-CMClientSettingSoftwareUpdate -InputObject $testsetting -Enable $true -ScanSchedule $Sch1 -DeploymentEvaluationSchedule $Sch2 -BatchingTimeout 3 -TimeUnit Days -EnforceMandatory $true -Office365ManagementType $false -EnableThirdPartyUpdates $true -EnableDeltaDownload $true -EnableInstallation $true -ThreadPriority Normal -EnableDynamicUpdate $true

Параметры

-BatchingTimeout

Укажите период времени, в течение которого также будут установлены все ожидающие развертывания с крайним сроком. Используйте этот параметр с параметром EnforceMandatory . Можно ввести значение от 1 до 23 часов и от 1 до 365 дней. По умолчанию этот параметр настраивается в течение семи дней. Используйте параметр TimeUnit , чтобы указать часы или дни.

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

-Confirm

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

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

-DefaultSetting

Добавьте этот параметр, чтобы настроить параметры обновления программного обеспечения в параметрах клиента по умолчанию.

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

-DeltaDownloadPort

Используйте этот параметр для настройки сетевого порта, который клиенты используют для получения запросов на разностное содержимое. Используйте параметр EnableDeltaDownload , чтобы включить поведение. Значение по умолчанию — 8005.

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

-DeploymentEvaluationSchedule

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

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

-DisableWildcardHandling

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

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

-Enable

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

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

-EnableDeltaDownload

Присвойте этому параметру значение , $true чтобы разрешить клиентам скачивать разностное содержимое, если оно доступно. Чтобы настроить сетевой порт, используйте параметр DeltaDownloadPort .

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

-EnableDynamicUpdate

Применяется к версии 2010 и более поздним. Задайте этому параметру значение , $true чтобы включить динамическое обновление для обновлений компонентов Windows 10. Динамическое обновление устанавливает языковые пакеты, компоненты по запросу, драйверы и накопительные обновления во время установки Windows. Он направляет клиент на скачивание этих обновлений из Интернета.

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

-EnableInstallation

Применяется к версии 2010 и более поздним. Присвойте этому параметру значение , $true чтобы включить установку обновлений программного обеспечения в период обслуживания "Все развертывания", когда доступен период обслуживания "Обновление программного обеспечения".

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

-EnableThirdPartyUpdates

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

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

-EnableWsusCertPinning

Применяется к версии 2107 и более поздним. Присвойте этому параметру значение , $true чтобы принудительно закрепить сертификат TLS для клиента Центра обновления Windows для обнаружения обновлений.

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

-EnforceMandatory

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

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

-ForceWildcardHandling

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

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

-InputObject

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

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

-Name

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

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

-Office365ManagementType

Присвойте этому параметру значение , $true чтобы включить управление агентом клиента Приложений Microsoft 365 и параметрами установки.

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

-PassThru

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

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

-ScanSchedule

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

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

-ThreadPriority

Применяется к версии 2010 и более поздним. Укажите приоритет потока для обновлений компонентов Windows 10.

  • Normal: программа установки Windows быстрее использует больше системных ресурсов и обновлений. Он использует больше времени процессора, поэтому общее время установки меньше, но сбой пользователя дольше. Это значение является значением по умолчанию.

  • Low: вы можете продолжать работать на устройстве, пока оно загружает и обновляется в фоновом режиме. Общее время установки больше, но сбой пользователя короче. Возможно, потребуется увеличить максимальное время выполнения обновления, чтобы избежать истечения времени ожидания при использовании этого параметра.

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

-TimeUnit

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

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

-WhatIf

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

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

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

System.Object