Set-CMClientSettingSoftwareUpdate

参考

模块:: ConfigurationManager

配置软件更新的客户端设置。

语法

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

通过

Set-CMClientSettingSoftwareUpdate

语法

说明

示例

示例 1：在默认客户端设置中启用第三方更新

示例 2：在自定义设备设置中启用第三方更新

示例 3：配置多个设置

参数

-BatchingTimeout

-Confirm

-DefaultSetting

-DeltaDownloadPort

-DeploymentEvaluationSchedule

-DisableWildcardHandling

-Enable

-EnableDeltaDownload

-EnableDynamicUpdate

-EnableInstallation

-EnableThirdPartyUpdates

-EnableWsusCertPinning

-EnforceMandatory

-ForceWildcardHandling

-InputObject

-Name

-Office365ManagementType

-PassThru

-ScanSchedule

-ThreadPriority

-TimeUnit

-WhatIf

输入

输出

反馈

其他资源

通过

Set-CMClientSettingSoftwareUpdate

语法

说明

示例

示例 1：在默认客户端设置中启用第三方更新

示例 2：在自定义设备设置中启用第三方更新

示例 3：配置多个设置

参数

-BatchingTimeout

-Confirm

-DefaultSetting

-DeltaDownloadPort

-DeploymentEvaluationSchedule

-DisableWildcardHandling

-Enable

-EnableDeltaDownload

-EnableDynamicUpdate

-EnableInstallation

-EnableThirdPartyUpdates

-EnableWsusCertPinning

-EnforceMandatory

-ForceWildcardHandling

-InputObject

-Name

-Office365ManagementType

-PassThru

-ScanSchedule

-ThreadPriority

-TimeUnit

-WhatIf

输入

输出

相关链接

反馈

其他资源