| external help file | Module Name | ms.date | schema | title |
|---|---|---|---|---|
AdminUI.PS.dll-Help.xml |
ConfigurationManager |
12/15/2021 |
2.0.0 |
Remove-CMSoftwareUpdatePoint |
Remove a software update point.
Remove-CMSoftwareUpdatePoint [-DefaultServerName <String>] [-Force] -InputObject <IResultObject>
[-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
Remove-CMSoftwareUpdatePoint [-DefaultServerName <String>] [-Force] [-SiteCode <String>]
[-SiteSystemServerName] <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
Use this cmdlet to remove a software update point site system role.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.
The cmdlet requires both the site code and the name. Because the command doesn't include the Force parameter, this example prompts you for confirmation.
Remove-CMSoftwareUpdatePoint -SiteCode "CM1" -SiteSystemServerName "UpdateSystem.Western.Contoso.com"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 variable. This command uses the Force parameter, so the cmdlet doesn't prompt you for confirmation.
$CMSUP = Get-CMSoftwareUpdatePoint -SiteCode "CM1" -SiteSystemServerName "UpdateSystem.Western.Contoso.com"
Remove-CMSoftwareUpdatePoint -InputObject $CMSUP -ForceSpecify the FQDN of the default software update point.
Type: String
Parameter Sets: (All)
Aliases: DefaultSoftwareUpdatePointServerName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseThis parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseAdd this parameter to run the cmdlet without asking for confirmation.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseThis parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseSpecify a software update point object to remove. To get this object, use the Get-CMSoftwareUpdatePoint cmdlet.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: SoftwareUpdatePoint
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: FalseSpecify the three-character code for the site.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseSpecify the name of a server that hosts the software update point.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases: Name, ServerName
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalsePrompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: FalseShows what would happen if the cmdlet runs. The cmdlet doesn't run.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: FalseThis cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.