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 参数。

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

Type:	String[]
Aliases:	AddCompanies
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AddLanguageSummaryDetail

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

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

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

Type:	String[]
Aliases:	AddLanguageSummaryDetails
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AddLanguageUpdateFile

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

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

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AddProduct

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

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

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

Type:	String[]
Aliases:	AddProducts
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AddProductFamily

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

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

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

Type:	String[]
Aliases:	AddProductFamilies
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AddUpdateClassification

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

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

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContentFileOption

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

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

Type:	ContentFileOptions
Accepted values:	FullFilesOnly, ExpressForWindows10Only
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultWsusServer

指定 WSUS 服务器的 FQDN。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableCallWsusCleanupWizard

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableManualCertManagement

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

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableSyncFailureAlert

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableThirdPartyUpdates

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

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FeatureUpdateMaxRuntimeMins

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

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

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ImmediatelyExpireSupersedence

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

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

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

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

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

Type:	Boolean
Aliases:	ImmediatelyExpireSupersedenceForNonFeature
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ImmediatelyExpireSupersedenceForFeature

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

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

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

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

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

Type:	IResultObject
Aliases:	Site, SiteComponent
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

Type:	String
Aliases:	SiteName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NonFeatureUpdateMaxRuntimeMins

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

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

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveCompany

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

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

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

Type:	String[]
Aliases:	RemoveCompanies
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveLanguageSummaryDetail

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

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

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

Type:	String[]
Aliases:	RemoveLanguageSummaryDetails
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveLanguageUpdateFile

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

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

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveProduct

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

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

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

Type:	String[]
Aliases:	RemoveProducts
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveProductFamily

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

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

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

Type:	String[]
Aliases:	RemoveProductFamilies
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveUpdateClassification

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

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

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ReportingEvent

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

Type:	ReportingEventType
Accepted values:	DoNotCreateWsusReportingEvents, CreateOnlyWsusStatusReportingEvents, CreateAllWsusReportingEvents
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Schedule

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

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

Type:	IResultObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SiteCode

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SynchronizeAction

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

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

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

Type:	SynchronizeActionType
Accepted values:	SynchronizeFromMicrosoftUpdate, SynchronizeFromAnUpstreamDataSourceLocation, DoNotSynchronizeFromMicrosoftUpdateOrUpstreamDataSource
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UpstreamSourceLocation

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

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WaitMonth

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

此参数依赖于 ImmediatelyExpireSupersedence 参数。

Type:	Int32
Aliases:	WaitMonthForNonFeature
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WaitMonthForFeature

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

此参数依赖于 ImmediatelyExpireSupersedenceForFeature 参数。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject

备注

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

相关链接

• Get-CMSoftwareUpdatePointComponent
• Add-CMSoftwareUpdatePoint
• 用于Configuration Manager的网站组件