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>]

Description

使用此 Cmdlet 來設定軟體更新點的月臺元件。 在您新增軟體更新點之後使用它，例如 使用 Add-CMSoftwareUpdatePoint Cmdlet。 您也可以使用此 Cmdlet 來重新設定現有的軟體更新點。

軟體更新點元件會與 Windows Server Update Services (WSUS) 伺服器互動，以設定更新設定、要求與上游更新來源進行同步處理，以及將更新從 WSUS 資料庫同步至中央站臺上的月臺伺服器資料庫。

如需詳細資訊，請 參閱 Configuration Manager 的站臺元件。

注意事項

從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。

範例

範例 1：修改軟體更新點站臺元件

第一個命令會從 XYZ 網站取得軟體更新點元件物件。 命令會將 物件儲存在 $supComp 變數中。

第二個命令會建立排程物件，每三天重複一次。

此範 例接著會 將 Cmdlet 參數展開至 parameters 變數。 不一定需要套用參數，只要讓您更輕鬆地讀取這麼長命令行的參數即可。

最後一個命令會修改軟體更新點元件的一般屬性。

$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 功能更新時，或在指定的一段時間之後，立即讓 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 Update 代理程式是否 (用戶端上的 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 功能更新之後，要等待 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 類別。

相關連結

• Get-CMSoftwareUpdatePointComponent
• Add-CMSoftwareUpdatePoint
• Configuration Manager 的月臺元件