Edit

Get-CMSoftwareUpdatePointComponent

  • Reference
Module:
ConfigurationManager

Get the site component for the software update point.

Syntax

Get-CMSoftwareUpdatePointComponent
   [-SiteCode <String>]
   [-SiteSystemServerName <String>]
   [-WsusSyncManager]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Use this cmdlet to get the site component for the software update point. You can use the cmdlet to view the component configuration, or to get an object to configure with the Set-CMSoftwareUpdatePointComponent cmdlet.

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.

For more information, see Site components for Configuration Manager.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

Example 1: Get a software update point component by name

This command gets a software update point component by using the site system server name.

Get-CMSoftwareUpdatePointComponent -SiteSystemServerName "Contoso-SiteSysSrv.Western.Contoso.com"

Example 2: Get a software update point component by site code

This command gets a software update point component by using the site code.

Get-CMSoftwareUpdatePointComponent -SiteCode "CM1"

Example 3: Show the status of third-party updates in the hierarchy

$SUPWsusSyncMgr = Get-CMSoftwareUpdatePointComponent -WsusSyncManager

$SUPWsusSyncMgr.Props | Where PropertyName -eq "EnableThirdPartyUpdates"

Parameters

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

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

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

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

-SiteCode

Specify the three-character code for the site from which to get the software update point component.

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

-SiteSystemServerName

Specify the FQDN of a site system server that has the software update point role.

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

-WsusSyncManager

By default, this cmdlet gets objects and properties from the SMS_WSUS_CONFIGURATION_MANAGER component. Add this parameter to get objects and properties from the SMS_WSUS_SYNC_MANAGER component.

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

Inputs

None

Outputs

IResultObject[]

IResultObject

Notes

For more information on this return object and its properties, see SMS_SCI_Component server WMI class.