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