Set-CMSoftwareUpdatePointComponent

Set-CMSoftwareUpdatePointComponent

Modifies a software update point.

Syntax

Parameter Set: SearchBySiteCodeMandatory
Set-CMSoftwareUpdatePointComponent -SiteCode <String> [-AddLanguageSummaryDetails <String[]> ] [-AddLanguageUpdateFile <String[]> ] [-AddUpdateClassification <String[]> ] [-EnableSyncFailureAlert <Boolean> ] [-EnableSynchronization <Boolean> ] [-ImmediatelyExpireSupersedence <Boolean> ] [-RemoveLanguageSummaryDetails <String[]> ] [-RemoveLanguageUpdateFile <String[]> ] [-RemoveUpdateClassification <String[]> ] [-ReportingEvent <ReportingEventType> {CreateAllWsusReportingEvents | CreateOnlyWsusStatusReportingEvents | DoNotCreateWsusReportingEvents} ] [-Schedule <IResultObject> ] [-SynchronizeAction <SynchronizeActionType> {DoNotSynchronizeFromMicrosoftUpdateOrUpstreamDataSource | SynchronizeFromAnUpstreamDataSourceLocation | SynchronizeFromMicrosoftUpdate} ] [-UpstreamSourceLocation <String> ] [-WaitMonth <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByNameMandatory
Set-CMSoftwareUpdatePointComponent -Name <String> [-AddLanguageSummaryDetails <String[]> ] [-AddLanguageUpdateFile <String[]> ] [-AddUpdateClassification <String[]> ] [-EnableSyncFailureAlert <Boolean> ] [-EnableSynchronization <Boolean> ] [-ImmediatelyExpireSupersedence <Boolean> ] [-RemoveLanguageSummaryDetails <String[]> ] [-RemoveLanguageUpdateFile <String[]> ] [-RemoveUpdateClassification <String[]> ] [-ReportingEvent <ReportingEventType> {CreateAllWsusReportingEvents | CreateOnlyWsusStatusReportingEvents | DoNotCreateWsusReportingEvents} ] [-Schedule <IResultObject> ] [-SynchronizeAction <SynchronizeActionType> {DoNotSynchronizeFromMicrosoftUpdateOrUpstreamDataSource | SynchronizeFromAnUpstreamDataSourceLocation | SynchronizeFromMicrosoftUpdate} ] [-UpstreamSourceLocation <String> ] [-WaitMonth <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByValueMandatory
Set-CMSoftwareUpdatePointComponent -InputObject <IResultObject> [-AddLanguageSummaryDetails <String[]> ] [-AddLanguageUpdateFile <String[]> ] [-AddUpdateClassification <String[]> ] [-EnableSyncFailureAlert <Boolean> ] [-EnableSynchronization <Boolean> ] [-ImmediatelyExpireSupersedence <Boolean> ] [-RemoveLanguageSummaryDetails <String[]> ] [-RemoveLanguageUpdateFile <String[]> ] [-RemoveUpdateClassification <String[]> ] [-ReportingEvent <ReportingEventType> {CreateAllWsusReportingEvents | CreateOnlyWsusStatusReportingEvents | DoNotCreateWsusReportingEvents} ] [-Schedule <IResultObject> ] [-SynchronizeAction <SynchronizeActionType> {DoNotSynchronizeFromMicrosoftUpdateOrUpstreamDataSource | SynchronizeFromAnUpstreamDataSourceLocation | SynchronizeFromMicrosoftUpdate} ] [-UpstreamSourceLocation <String> ] [-WaitMonth <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed 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.

Parameters

-AddLanguageSummaryDetails<String[]>

Specifies an array of languages, as strings. The cmdlet adds these languages to the languages supported for summary details at this site. Summary details information specifies the languages to download the metadata for the software updates during synchronization, such as name, description, products that the update supports, update classification, article ID, download URL, and applicability rules.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-AddLanguageUpdateFile<String[]>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-AddUpdateClassification<String[]>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EnableSyncFailureAlert<Boolean>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EnableSynchronization<Boolean>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ImmediatelyExpireSupersedence<Boolean>

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 2012 Endpoint Protection definition updates and software updates that Service Packs supersede never expire.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-InputObject<IResultObject>

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

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Name<String>

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

Aliases

SiteName

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-RemoveLanguageSummaryDetails<String[]>

Specifies an array of languages, as strings. The cmdlet removes these languages from the languages supported for summary details at this site. Summary details information specifies the languages to download the metadata for the software updates during synchronization, such as name, description, products that the update supports, update classification, article ID, download URL, and applicability rules.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-RemoveLanguageUpdateFile<String[]>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-RemoveUpdateClassification<String[]>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ReportingEvent<ReportingEventType>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Schedule<IResultObject>

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.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SiteCode<String>

Specifies a site code in Configuration Manager.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SynchronizeAction<SynchronizeActionType>

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.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-UpstreamSourceLocation<String>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-WaitMonth<Int32>

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.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

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

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Modify a software update point

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.

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

Get-CMSoftwareUpdatePointComponent

New-CMSchedule

Set-CMCollectionMembershipEvaluationComponent

Set-CMEmailNotificationComponent

Set-CMManagementPointComponent

Set-CMOutOfBandManagementComponent

Set-CMStatusReportingComponent

Set-CMSystemHealthValidatorPointComponent