Set-​CM​Software​Update​Point​Component

Modifies a software update point.

Syntax

Set-CMSoftwareUpdatePointComponent
   [-AddCompany <String[]>]
   [-AddLanguageSummaryDetail <String[]>]
   [-AddLanguageUpdateFile <String[]>]
   [-AddProduct <String[]>]
   [-AddProductFamily <String[]>]
   [-AddUpdateClassification <String[]>]
   [-Confirm]
   [-ContentFileOption <ContentFileOptions>]
   [-DefaultWsusServer <String>]
   [-DisableWildcardHandling]
   [-EnableCallWsusCleanupWizard <Boolean>]
   [-EnableSyncFailureAlert <Boolean>]
   [-EnableSynchronization <Boolean>]
   [-ForceWildcardHandling]
   [-ImmediatelyExpireSupersedence <Boolean>]
   -InputObject <IResultObject>
   [-PassThru]
   [-RemoveCompany <String[]>]
   [-RemoveLanguageSummaryDetail <String[]>]
   [-RemoveLanguageUpdateFile <String[]>]
   [-RemoveProduct <String[]>]
   [-RemoveProductFamily <String[]>]
   [-RemoveUpdateClassification <String[]>]
   [-ReportingEvent <ReportingEventType>]
   [-Schedule <IResultObject>]
   [-SynchronizeAction <SynchronizeActionType>]
   [-UpstreamSourceLocation <String>]
   [-WaitMonth <Int32>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMSoftwareUpdatePointComponent
   [-AddCompany <String[]>]
   [-AddLanguageSummaryDetail <String[]>]
   [-AddLanguageUpdateFile <String[]>]
   [-AddProduct <String[]>]
   [-AddProductFamily <String[]>]
   [-AddUpdateClassification <String[]>]
   [-Confirm]
   [-ContentFileOption <ContentFileOptions>]
   [-DefaultWsusServer <String>]
   [-DisableWildcardHandling]
   [-EnableCallWsusCleanupWizard <Boolean>]
   [-EnableSyncFailureAlert <Boolean>]
   [-EnableSynchronization <Boolean>]
   [-ForceWildcardHandling]
   [-ImmediatelyExpireSupersedence <Boolean>]
   -Name <String>
   [-PassThru]
   [-RemoveCompany <String[]>]
   [-RemoveLanguageSummaryDetail <String[]>]
   [-RemoveLanguageUpdateFile <String[]>]
   [-RemoveProduct <String[]>]
   [-RemoveProductFamily <String[]>]
   [-RemoveUpdateClassification <String[]>]
   [-ReportingEvent <ReportingEventType>]
   [-Schedule <IResultObject>]
   [-SynchronizeAction <SynchronizeActionType>]
   [-UpstreamSourceLocation <String>]
   [-WaitMonth <Int32>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMSoftwareUpdatePointComponent
   [-AddCompany <String[]>]
   [-AddLanguageSummaryDetail <String[]>]
   [-AddLanguageUpdateFile <String[]>]
   [-AddProduct <String[]>]
   [-AddProductFamily <String[]>]
   [-AddUpdateClassification <String[]>]
   [-Confirm]
   [-ContentFileOption <ContentFileOptions>]
   [-DefaultWsusServer <String>]
   [-DisableWildcardHandling]
   [-EnableCallWsusCleanupWizard <Boolean>]
   [-EnableSyncFailureAlert <Boolean>]
   [-EnableSynchronization <Boolean>]
   [-ForceWildcardHandling]
   [-ImmediatelyExpireSupersedence <Boolean>]
   [-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>]
   [-WhatIf]
   [<CommonParameters>]

Description

The Set-CMSoftwareUpdatePointComponent cmdlet modifies a software update point. A software update point component interacts with a Windows Server Update Services (WSUS) server to configure update settings, request synchronization to the upstream update source, and synchronize updates from the WSUS database to the site server database on the central site.

You can specify a software update point to modify by name, by site code, or by using the Get-CMSoftwareUpdatePointComponent cmdlet.

Examples

Example 1: Modify a software update point

PS C:\> $CIObj = Get-CMSoftwareUpdatePointComponent -SiteSystemServerName "Contoso-SiteSysSrv.Western.Contoso.com"
PS C:\> Set-CMSoftwareUpdatePointComponent -InputObject $CIObj

The first command retrieves a software update point component object on the server named Contoso-SiteSysSrv.TSQA.Contoso.com. The command stores the object in the $CIObj variable.

The second command modifies the software update point component in $CIObj.

Required Parameters

-InputObject

Specifies a software update point component object. To obtain a software update point component object, use the Get-CMSoftwareUpdatePointComponent cmdlet.

Type:IResultObject
Aliases:Site, SiteComponent
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Name

Specifies a name of a site system server in Configuration Manager.

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

Optional Parameters

-AddCompany
Type:String[]
Aliases:AddCompanies
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AddLanguageSummaryDetail
Type:String[]
Aliases:AddLanguageSummaryDetails
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AddLanguageUpdateFile

Specifies an array of languages, as strings. The cmdlet adds these languages to the languages supported for software updates at this site.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AddProduct
Type:String[]
Aliases:AddProducts
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AddProductFamily
Type:String[]
Aliases:AddProductFamilies
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AddUpdateClassification

Specifies an array of software update classifications, as strings. This cmdlet adds these classifications to the classifications supported for software updates at this site.

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

Prompts you for confirmation before running the cmdlet.

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

{{Fill ContentFileOption Description}}

Type:ContentFileOptions
Parameter Sets:FullFilesOnly, ExpressForWindows10Only
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DefaultWsusServer
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableCallWsusCleanupWizard
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableSyncFailureAlert

Indicates whether Configuration Manager creates an alert when synchronization fails on a site.

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

Indicates whether this site automatically synchronizes updates according to a schedule. Specify a schedule by using the Schedule parameter.

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

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

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

Indicates whether a software update expires immediately after another update supersedes it or after a specified period of time. If you specify a value of $False for this parameter, specify the number of months to wait for expiration by using the WaitMonth parameter.System Center 2016 Endpoint Protection definition updates and software updates that Service Packs supersede never expire.

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

{{Fill PassThru Description}}

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RemoveCompany
Type:String[]
Aliases:RemoveCompanies
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RemoveLanguageSummaryDetail
Type:String[]
Aliases:RemoveLanguageSummaryDetails
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RemoveLanguageUpdateFile

Specifies an array of languages, as strings. The cmdlet removes these languages from the languages supported for software updates at this site.

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

Specifies an array of products, as strings.

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

Specifies an array of product families, as strings.

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

Specifies an array of software update classifications, as strings. This cmdlet removes these classifications from the classifications supported for software updates at this site.

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

Specifies whether to create event messages for WSUS reporting for status reporting events or for all reporting events. The acceptable values for this parameter are:- CreateAllWsusReportingEvents

  • CreateOnlyWsusStatusReportingEvents
  • DoNotCreateWsusReportingEvents
Type:ReportingEventType
Parameter Sets:DoNotCreateWsusReportingEvents, CreateOnlyWsusStatusReportingEvents, CreateAllWsusReportingEvents
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Schedule

Specifies a Schedule object. Configuration Manager can synchronize updates according this schedule if you specify a value of $True for the EnableSynchronization parameter. To obtain a Schedule object, use the New-CMSchedule cmdlet.

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

Specifies a site code in Configuration Manager.

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

Specifies a source for synchronization for this software update point. The acceptable values for this parameter are:- DoNotSynchronizeFromMicrosoftUpdateOrUpstreamDataSource

  • SynchronizeFromAnUpstreamDataSourceLocation
  • SynchronizeFromMicrosoftUpdate

    If you select a value of SynchronizeFromAnUpstreamDataSourceLocation, specify the data source location by using the UpstreamSourceLocation parameter.
Type:SynchronizeActionType
Parameter Sets:SynchronizeFromMicrosoftUpdate, SynchronizeFromAnUpstreamDataSourceLocation, DoNotSynchronizeFromMicrosoftUpdateOrUpstreamDataSource
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UpstreamSourceLocation

Specifies an upstream data location as a URL. To use this location, specify a value of SynchronizeFromAnUpstreamDataSourceLocation for the SynchronizeAction parameter.

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

Specifies how long, in months, to wait before a software update expires after another update supersedes it. Specify a value of $True for the ImmediatelyExpireSupersedence parameter for software updates to expire immediately.Endpoint Protection definition updates and software updates that Service Packs supersede never expire.

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

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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