Remove-​CM​Software​Update​Point

Removes a software update point site system role from Configuration Manager.

Syntax

Remove-CMSoftwareUpdatePoint
      [-Confirm]
      [-DisableWildcardHandling]
      [-Force]
      [-ForceWildcardHandling]
      -InputObject <IResultObject>
      [-WhatIf]
      [<CommonParameters>]
Remove-CMSoftwareUpdatePoint
      [-SiteSystemServerName] <String>
      [-Confirm]
      [-DisableWildcardHandling]
      [-Force]
      [-ForceWildcardHandling]
      [-SiteCode <String>]
      [-WhatIf]
      [<CommonParameters>]

Description

The Remove-CMSoftwareUpdatePoint cmdlet removes a software update point site system role from Microsoft System Center Configuration Manager.

A software update point is a site server role that hosts software updates. System Center Configuration Manager clients connect to a software update point to get available updates. The software update point interacts with Windows Server Update Services (WSUS) to configure update settings, request synchronization to the update source, and to synchronize software updates from the WSUS database.

You can specify a software update point to remove by site code and the name of the computer that hosts the site system role. You can also use the Get-CMSoftwareUpdatePoint cmdlet to obtain a software update point.

Examples

Example 1: Remove a software update point

PS C:\> Remove-CMSoftwareUpdatePoint -SiteCode "CM1" -SiteSystemServerName "UpdateSystem.Western.Contoso.com"

The command removes a software update point. The cmdlet requires both the site code and the name. Because the command does not include the Force parameter, the cmdlet prompts you for confirmation.

Example 2: Remove a software update point by using a variable

PS C:\> $CMSUP = Get-CMSoftwareUpdatePoint -SiteCode "CM1" -SiteSystemServerName "UpdateSystem.Western.Contoso.com"
PS C:\> Remove-CMSoftwareUpdatePoint -InputObject $CMSUP -Force

The first command gets a software update point and saves it to the $CMSUP variable.

The second command removes the software update point saved in the $CMSUP variable. This command uses the Force parameter, so the cmdlet does not prompt you for confirmation.

Required Parameters

-InputObject

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

Type:IResultObject
Aliases:SoftwareUpdatePoint
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-SiteSystemServerName

Specifies the name of a computer that hosts the software update point site system role.

Type:String
Aliases:Name, ServerName
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

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

Forces the command to run without asking for user confirmation.

Type:SwitchParameter
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
-SiteCode

Specifies a site code for a Configuration Manager site.

Type:String
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