Set-CMSoftwareUpdatePointComponent

参考

模块:: ConfigurationManager

为软件更新点配置站点组件。

语法

Set-CMSoftwareUpdatePointComponent
   [-AddCompany <String[]>]
   [-AddLanguageSummaryDetail <String[]>]
   [-AddLanguageUpdateFile <String[]>]
   [-AddProduct <String[]>]
   [-AddProductFamily <String[]>]
   [-AddUpdateClassification <String[]>]
   [-ContentFileOption <ContentFileOptions>]
   [-DefaultWsusServer <String>]
   [-EnableCallWsusCleanupWizard <Boolean>]
   [-EnableManualCertManagement <Boolean>]
   [-EnableSyncFailureAlert <Boolean>]
   [-EnableThirdPartyUpdates <Boolean>]
   [-FeatureUpdateMaxRuntimeMins <Int32>]
   [-ImmediatelyExpireSupersedence <Boolean>]
   [-ImmediatelyExpireSupersedenceForFeature <Boolean>]
   [-NonFeatureUpdateMaxRuntimeMins <Int32>]
   [-PassThru]
   [-RemoveCompany <String[]>]
   [-RemoveLanguageSummaryDetail <String[]>]
   [-RemoveLanguageUpdateFile <String[]>]
   [-RemoveProduct <String[]>]
   [-RemoveProductFamily <String[]>]
   [-RemoveUpdateClassification <String[]>]
   [-ReportingEvent <ReportingEventType>]
   [-Schedule <IResultObject>]
   [-SiteCode <String>]
   [-SynchronizeAction <SynchronizeActionType>]
   [-UpstreamSourceLocation <String>]
   [-WaitMonth <Int32>]
   [-WaitMonthForFeature <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMSoftwareUpdatePointComponent
   [-AddCompany <String[]>]
   [-AddLanguageSummaryDetail <String[]>]
   [-AddLanguageUpdateFile <String[]>]
   [-AddProduct <String[]>]
   [-AddProductFamily <String[]>]
   [-AddUpdateClassification <String[]>]
   [-ContentFileOption <ContentFileOptions>]
   [-DefaultWsusServer <String>]
   [-EnableCallWsusCleanupWizard <Boolean>]
   [-EnableManualCertManagement <Boolean>]
   [-EnableSyncFailureAlert <Boolean>]
   [-EnableThirdPartyUpdates <Boolean>]
   [-FeatureUpdateMaxRuntimeMins <Int32>]
   [-ImmediatelyExpireSupersedence <Boolean>]
   [-ImmediatelyExpireSupersedenceForFeature <Boolean>]
   -Name <String>
   [-NonFeatureUpdateMaxRuntimeMins <Int32>]
   [-PassThru]
   [-RemoveCompany <String[]>]
   [-RemoveLanguageSummaryDetail <String[]>]
   [-RemoveLanguageUpdateFile <String[]>]
   [-RemoveProduct <String[]>]
   [-RemoveProductFamily <String[]>]
   [-RemoveUpdateClassification <String[]>]
   [-ReportingEvent <ReportingEventType>]
   [-Schedule <IResultObject>]
   [-SynchronizeAction <SynchronizeActionType>]
   [-UpstreamSourceLocation <String>]
   [-WaitMonth <Int32>]
   [-WaitMonthForFeature <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMSoftwareUpdatePointComponent
   [-AddCompany <String[]>]
   [-AddLanguageSummaryDetail <String[]>]
   [-AddLanguageUpdateFile <String[]>]
   [-AddProduct <String[]>]
   [-AddProductFamily <String[]>]
   [-AddUpdateClassification <String[]>]
   [-ContentFileOption <ContentFileOptions>]
   [-DefaultWsusServer <String>]
   [-EnableCallWsusCleanupWizard <Boolean>]
   [-EnableManualCertManagement <Boolean>]
   [-EnableSyncFailureAlert <Boolean>]
   [-EnableThirdPartyUpdates <Boolean>]
   [-FeatureUpdateMaxRuntimeMins <Int32>]
   [-ImmediatelyExpireSupersedence <Boolean>]
   [-ImmediatelyExpireSupersedenceForFeature <Boolean>]
   -InputObject <IResultObject>
   [-NonFeatureUpdateMaxRuntimeMins <Int32>]
   [-PassThru]
   [-RemoveCompany <String[]>]
   [-RemoveLanguageSummaryDetail <String[]>]
   [-RemoveLanguageUpdateFile <String[]>]
   [-RemoveProduct <String[]>]
   [-RemoveProductFamily <String[]>]
   [-RemoveUpdateClassification <String[]>]
   [-ReportingEvent <ReportingEventType>]
   [-Schedule <IResultObject>]
   [-SynchronizeAction <SynchronizeActionType>]
   [-UpstreamSourceLocation <String>]
   [-WaitMonth <Int32>]
   [-WaitMonthForFeature <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

使用此 cmdlet 为软件更新点配置站点组件。在添加软件更新点（例如，使用 Add-CMSoftwareUpdatePoint cmdlet）后使用它。还可以使用此 cmdlet 重新配置现有软件更新点。

软件更新点组件与 Windows Server Update Services (WSUS) 服务器交互，以配置更新设置、请求同步到上游更新源，以及将 WSUS 数据库中的更新同步到中央站点上的站点服务器数据库。

有关详细信息，请参阅 Configuration Manager 的站点组件。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。有关详细信息，请参阅入门。

示例

示例 1：修改软件更新点站点组件

第一个命令从 XYZ 站点获取软件更新点组件对象。命令将对象存储在 $supComp 变量中。

第二个命令创建一个计划对象，每三天重复一次。

然后，此示例将 cmdlet 参数 splat 到 parameters 变量中。不需要对参数进行 splat，它只是便于读取如此长的命令行的参数。

最后一个命令修改软件更新点组件的通用属性。

$supComp = Get-CMSoftwareUpdatePointComponent -SiteSystemServerName 'sup1.contoso.com' -SiteCode 'XYZ'

$schedule = New-CMSchedule -RecurCount 3 -RecurInterval Days -Start "2020/1/7 12:00:00"

$addLang = "Dutch"
$removeLang = "English"

$parameters = @{
  InputObject = $supComp
  DefaultWsusServer = 'sup.contoso.com'
  SynchronizeAction = 'SynchronizeFromMicrosoftUpdate'
  ReportingEvent = 'CreateAllWsusReportingEvents'
  RemoveUpdateClassification = "Update Rollups"
  AddUpdateClassification = "Critical Updates"
  Schedule = $schedule
  EnableSyncFailureAlert = $true
  ImmediatelyExpireSupersedence = $true
  AddLanguageUpdateFile = $addLang
  AddLanguageSummaryDetails = $addLang
  RemoveLanguageUpdateFile = $removeLang
  RemoveLanguageSummaryDetails = $removeLang
}

Set-CMSoftwareUpdatePointComponent @parameters

示例 2：禁用软件更新点同步

以下命令从站点组件中删除计划，这将禁用同步。

Set-CMSoftwareUpdatePointComponent -Name "Contoso-SiteSysSrv.Western.Contoso.com" -Schedule $null

参数

-AddCompany

此参数是公司名称的字符串数组。使用此选项可同步整个公司 的产品列表。

若要从此列表中删除整个公司，请使用 RemoveCompany 参数。

有关详细信息，请参阅配置要同步的分类和产品。

类型:	String[]
别名:	AddCompanies
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AddLanguageSummaryDetail

此参数是语言名称的字符串数组。使用此选项可下载指定语言的 摘要详细信息 。

若要从此列表中删除语言，请使用 RemoveLanguageSummaryDetail 参数。

有关详细信息，请参阅规划同步设置 - 语言。

类型:	String[]
别名:	AddLanguageSummaryDetails
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AddLanguageUpdateFile

此参数是语言名称的字符串数组。使用此选项下载指定语言的 软件更新文件 。

若要从此列表中删除语言，请使用 RemoveLanguageUpdateFile 参数。

有关详细信息，请参阅规划同步设置 - 语言。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AddProduct

此参数是产品名称的字符串数组。使用此选项可同步产品。

若要从此列表中删除产品，请使用 RemoveProduct 参数。

有关详细信息，请参阅配置要同步的分类和产品。

类型:	String[]
别名:	AddProducts
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AddProductFamily

此参数是产品系列名称的字符串数组。使用此选项可同步产品系列的 “产品”列表。

若要从此列表中删除整个产品系列，请使用 RemoveProductFamily 参数。

有关详细信息，请参阅配置要同步的分类和产品。

类型:	String[]
别名:	AddProductFamilies
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AddUpdateClassification

此参数是更新分类的字符串数组。使用此选项可同步特定的软件更新分类。

若要从此列表中删除分类，请使用 RemoveUpdateClassification 参数。

有关详细信息，请参阅配置要同步的分类和产品。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-ContentFileOption

使用此参数可配置软件更新点下载更新文件的方式。快速安装文件在计算机上提供更小的下载和更快的安装速度，因为仅下载并安装了必要的文件。这些文件较大，会增加站点服务器和分发点的下载时间。

FullFilesOnly：下载所有已批准的更新的完整文件
ExpressForWindows10Only：下载所有已批准更新的完整文件和适用于 Windows 10 或更高版本的快速安装文件

类型:	ContentFileOptions
接受的值:	FullFilesOnly, ExpressForWindows10Only
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultWsusServer

指定 WSUS 服务器的 FQDN。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisableWildcardHandling

此参数将通配符视为文本字符值。不能将其与 ForceWildcardHandling 组合使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnableCallWsusCleanupWizard

将此参数设置为以 $true 启用在同步后运行的 WSUS 清理任务。有关详细信息，请参阅软件更新维护。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnableManualCertManagement

将此参数设置为 $true 可手动管理第三方更新的 WSUS 签名证书。此参数依赖于 EnableThirdPartyUpdates 参数。

有关详细信息，请参阅启用第三方更新。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnableSyncFailureAlert

将此参数设置为， $true 使组件能够在同步失败时创建警报。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnableThirdPartyUpdates

将此参数设置为 $true“启用第三方软件更新”。还可以使用 EnableManualCertManagement 参数。

有关详细信息，请参阅启用第三方更新。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-FeatureUpdateMaxRuntimeMins

指定软件更新安装必须完成的默认最长时间的整数值。对于特定更新，可以重写此默认值。此设置仅影响新同步的更新。此参数仅适用于 Windows 功能更新。

若要为 Windows 配置 Office 365 更新和非功能更新的最大运行时间，请使用 NonFeatureUpdateMaxRuntimeMins 参数。

有关详细信息，请参阅规划同步设置。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为， (不建议) 。不能将其与 DisableWildcardHandling 组合使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ImmediatelyExpireSupersedence

将此参数设置为， $true 以在另一个更新取代软件更新时或在指定时间段后立即使软件更新过期。

如果为此参数指定值 $False ，请使用 WaitMonth 参数指定等待过期的月数。

某些更新永不过期，例如定义更新。

如果更改此设置，站点将启动完全同步。

若要为 Windows 功能更新配置此行为，请使用 ImmediatelyExpireSupersedenceForFeature 参数。

类型:	Boolean
别名:	ImmediatelyExpireSupersedenceForNonFeature
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ImmediatelyExpireSupersedenceForFeature

将此参数设置为以 $true 在另一个更新取代 Windows 功能更新时或在指定时间段后立即使它过期。

如果为此参数指定值 $False ，请使用 WaitMonthForFeature 参数指定等待过期的月数。

如果更改此设置，站点将启动完全同步。

若要为非功能更新配置此行为，请使用 ImmediatelyExpireSupersedence 参数。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InputObject

指定要配置的软件更新点站点组件对象。若要获取此对象，请使用 Get-CMSoftwareUpdatePointComponent cmdlet。

类型:	IResultObject
别名:	Site, SiteComponent
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Name

指定具有软件更新点角色的站点系统服务器的名称。

类型:	String
别名:	SiteName
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-NonFeatureUpdateMaxRuntimeMins

指定软件更新安装必须完成的默认最长时间的整数值。对于特定更新，可以重写此默认值。此设置仅影响新同步的更新。此参数仅适用于 Windows 的 Office 365 更新和非功能更新。

若要配置 Windows 功能更新的最大运行时间，请使用 FeatureUpdateMaxRuntimeMins 参数。

有关详细信息，请参阅规划同步设置。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PassThru

添加此参数可返回一个对象，该对象表示正在使用的项。默认情况下，此 cmdlet 可能不会生成任何输出。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoveCompany

此参数是公司名称的字符串数组。使用此选项不同步整个公司 的产品列表。

若要将整个公司添加到此列表，请使用 AddCompany 参数。

有关详细信息，请参阅配置要同步的分类和产品。

类型:	String[]
别名:	RemoveCompanies
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoveLanguageSummaryDetail

此参数是语言名称的字符串数组。使用此选项不下载指定语言的 摘要详细信息 。

若要向此列表添加语言，请使用 AddLanguageSummaryDetail 参数。

有关详细信息，请参阅规划同步设置 - 语言。

类型:	String[]
别名:	RemoveLanguageSummaryDetails
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoveLanguageUpdateFile

此参数是语言名称的字符串数组。使用此选项不下载指定语言的 软件更新文件 。

若要向此列表添加语言，请使用 AddLanguageUpdateFile 参数。

有关详细信息，请参阅规划同步设置 - 语言。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoveProduct

此参数是产品名称的字符串数组。使用此选项不同步产品。

若要将产品添加到此列表，请使用 AddProduct 参数。

有关详细信息，请参阅配置要同步的分类和产品。

类型:	String[]
别名:	RemoveProducts
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoveProductFamily

此参数是产品系列名称的字符串数组。使用此选项不同步产品系列的 “产品”列表。

若要将整个产品系列添加到此列表，请使用 AddProductFamily 参数。

有关详细信息，请参阅配置要同步的分类和产品。

类型:	String[]
别名:	RemoveProductFamilies
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoveUpdateClassification

此参数是更新分类的字符串数组。使用此选项不同步特定的软件更新分类。

若要向此列表添加分类，请使用 AddUpdateClassification 参数。

有关详细信息，请参阅配置要同步的分类和产品。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ReportingEvent

指定客户端上的 Windows 更新代理 (WUA) 是否为 WSUS 报告创建事件消息。 Configuration Manager 不会使用这些事件。请勿创建这些事件，除非需要它们用于其他用途。

类型:	ReportingEventType
接受的值:	DoNotCreateWsusReportingEvents, CreateOnlyWsusStatusReportingEvents, CreateAllWsusReportingEvents
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Schedule

指定 Schedule 对象以启用同步。若要禁用同步，请将此参数设置为 $null。

若要获取计划对象，请使用 New-CMSchedule cmdlet。

类型:	IResultObject
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SiteCode

为要配置其软件更新点组件的站点指定三字符代码。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SynchronizeAction

指定此软件更新点的同步源。

如果选择的值 SynchronizeFromAnUpstreamDataSourceLocation，请使用 UpstreamSourceLocation 参数指定数据源位置。

有关详细信息，请参阅规划同步设置。

类型:	SynchronizeActionType
接受的值:	SynchronizeFromMicrosoftUpdate, SynchronizeFromAnUpstreamDataSourceLocation, DoNotSynchronizeFromMicrosoftUpdateOrUpstreamDataSource
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UpstreamSourceLocation

将上游数据位置指定为 URL。例如，https://wsusserver.contoso.com:8531

若要使用此位置，请为 SynchronizeAction 参数指定 SynchronizeFromAnUpstreamDataSourceLocation 。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WaitMonth

将软件更新在另一个更新取代之前等待的月数设置为整数值。

此参数依赖于 ImmediatelyExpireSupersedence 参数。

类型:	Int32
别名:	WaitMonthForNonFeature
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WaitMonthForFeature

设置 Windows 功能更新在另一个更新取代它之前等待的月数的整数值。

此参数依赖于 ImmediatelyExpireSupersedenceForFeature 参数。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject

备注

有关此返回对象及其属性的详细信息，请参阅 SMS_SCI_Component服务器 WMI 类。

通过

Set-CMSoftwareUpdatePointComponent

语法

说明

示例

示例 1：修改软件更新点站点组件

示例 2：禁用软件更新点同步

参数

-AddCompany

-AddLanguageSummaryDetail

-AddLanguageUpdateFile

-AddProduct

-AddProductFamily

-AddUpdateClassification

-Confirm

-ContentFileOption

-DefaultWsusServer

-DisableWildcardHandling

-EnableCallWsusCleanupWizard

-EnableManualCertManagement

-EnableSyncFailureAlert

-EnableThirdPartyUpdates

-FeatureUpdateMaxRuntimeMins

-ForceWildcardHandling

-ImmediatelyExpireSupersedence

-ImmediatelyExpireSupersedenceForFeature

-InputObject

-Name

-NonFeatureUpdateMaxRuntimeMins

-PassThru

-RemoveCompany

-RemoveLanguageSummaryDetail

-RemoveLanguageUpdateFile

-RemoveProduct

-RemoveProductFamily

-RemoveUpdateClassification

-ReportingEvent

-Schedule

-SiteCode

-SynchronizeAction

-UpstreamSourceLocation

-WaitMonth

-WaitMonthForFeature

-WhatIf

输入

输出

备注

相关链接

反馈

其他资源