Remove-CMSoftwareUpdatePoint
Remove-CMSoftwareUpdatePoint
Removes a software update point site system role from Configuration Manager.
Syntax
Parameter Set: SearchByNameMandatory
Remove-CMSoftwareUpdatePoint -SiteCode <String> -SiteSystemServerName <String> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByValueMandatory
Remove-CMSoftwareUpdatePoint -InputObject <IResultObject> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Remove-CMSoftwareUpdatePoint cmdlet removes a software update point site system role from Microsoft System Center 2012 Configuration Manager.
A software update point is a site server role that hosts software updates. System Center 2012 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.
Parameters
-Force
Removes a software update point without prompting you for confirmation. By default, the cmdlet prompts you for confirmation before it proceeds.
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 object. To obtain a software update point object, use the Get-CMSoftwareUpdatePoint cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SiteCode<String>
Specifies a site code for a Configuration Manager site.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SiteSystemServerName<String>
Specifies the name of a computer that hosts the software update point site system role.
Aliases |
none |
Required? |
true |
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: Remove a software update point
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.
PS C:\> Remove-CMSoftwareUpdatePoint -SiteCode "CM1" -SiteSystemServerName "UpdateSystem.Western.Contoso.com"
Example 2: Remove a software update point by using a variable
The example removes a software update point.
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.
PS C:\> $CMSUP = Get-CMSoftwareUpdatePoint -SiteCode "CM1" -SiteSystemServerName "UpdateSystem.Western.Contoso.com"
PS C:\> Remove-CMSoftwareUpdatePoint -InputObject $CMSUP -Force