共用方式為


Set-CMSoftwareUpdatePointComponent

設定軟體更新點的月臺元件。

語法

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 類別