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>] 说明
使用此 cmdlet 在客户端设置的 软件更新 组中配置设置。 有关详细信息，请参阅 关于客户端设置：软件更新。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 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 天的值。 默认情况下，此设置配置为 7 天。 使用 TimeUnit 参数可以指定小时或天数。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DefaultSetting
添加此参数以在默认客户端设置中配置软件更新设置。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-DeltaDownloadPort
使用此参数可配置客户端用于接收增量内容请求的网络端口。 使用 EnableDeltaDownload 参数启用该行为。 默认值为 8005。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DeploymentEvaluationSchedule
指定软件更新客户端代理在 Configuration Manager 客户端计算机上重新评估软件更新的安装状态的频率。 若要创建新的计划令牌，请使用 New-CMSchedule cmdlet。
| 类型: | IResultObject |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Enable
将此参数设置为 $true 以在客户端上启用软件更新。
| 类型: | Boolean |
| 别名: | EnableSoftwareUpdatesOnClient |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EnableDeltaDownload
将此参数设置为 以 $true 允许客户端在可用时下载增量内容。 若要配置网络端口，请使用 DeltaDownloadPort 参数。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EnableDynamicUpdate
适用于版本 2010 及更高版本。 将此参数设置为 以 $true 启用 Windows 10 功能更新的动态更新。 动态更新在 Windows 安装过程中安装语言包、按需功能、驱动程序和累积更新。 它指示客户端从 Internet 下载这些更新。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EnableInstallation
适用于版本 2010 及更高版本。 将此参数设置为 ， $true 以便在“软件更新”维护时段可用时，在“所有部署”维护时段内启用软件更新安装。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EnableThirdPartyUpdates
将此参数设置为 $true 以启用第三方软件更新。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EnableWsusCertPinning
适用于版本 2107 及更高版本。 将此参数设置为 以 $true 强制 WINDOWS 更新客户端的 TLS 证书固定以检测更新。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EnforceMandatory
当达到任何软件更新部署截止时间时，请安装所有其他软件更新部署，最后期限在指定时间段内。 使用 BatchingTimeout 参数指定时间段。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-InputObject
此 cmdlet 将软件更新设置添加到使用此参数指定的客户端设置对象。 若要获取此对象，请使用 Get-CMClientSetting cmdlet。
| 类型: | IResultObject |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-Name
此 cmdlet 将软件更新设置添加到此参数命名的客户端设置对象。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Office365ManagementType
将此参数设置为 以 $true 启用 Microsoft 365 Apps 客户端代理和安装设置的管理。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PassThru
返回一个 对象，该对象表示正在使用的项。 默认情况下，此 cmdlet 可能不会生成任何输出。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ScanSchedule
指定软件更新客户端代理启动合规性评估扫描的频率。 此扫描确定客户端上软件更新的状态。 若要创建新的计划令牌，请使用 New-CMSchedule cmdlet。
| 类型: | IResultObject |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ThreadPriority
适用于版本 2010 及更高版本。 指定 Windows 10 功能更新的线程优先级。
Normal：Windows 安装程序使用更多的系统资源和更快的更新。 它使用更多的处理器时间，因此总安装时间较短，但用户的中断时间更长。 此值为默认值。Low：在后台下载和更新设备时，可以继续在设备上工作。 总安装时间较长，但用户的中断时间较短。 使用此选项时，可能需要增加更新最大运行时间以避免超时。
| 类型: | ThreadPriorityType |
| 接受的值: | Normal, Low |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-TimeUnit
与 BatchingTimeout 参数一起使用可指定同时安装此时间段内最后期限的所有挂起部署。
| 类型: | BatchingTimeoutType |
| 接受的值: | Days, Hours |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 该 cmdlet 未运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
System.Object