Remove-CMSiteSystemServer

Removes a site system server.

Syntax

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

Description

The Remove-CMSiteSystemServer cmdlet removes a site system server from Microsoft System Center Configuration Manager. If the site system server has other site system roles besides the site system role, this cmdlet will fail.

Examples

Example 1: Remove a site system server by using the pipeline

PS C:\> Get-CMSiteSystemServer -SiteSystemServerName "Server2.contoso.com" -SiteCode "MP5" | Remove-CMSiteSystemServer -Force

This command gets the site system server object named Server2.contoso.com with the site code MP5 and uses the pipeline operator to pass the object to Remove-CMSiteSystemServer, which removes the site system server object.

Example 2: Remove a site system server

PS C:\> Remove-CMSiteSystemServer -SiteSystemServerName "Server2.contoso.com" -SiteCode "MP5" -Force

This command removes the site system server named Server2.contoso.com with the site code MP5.

Required Parameters

-InputObject

Specifies a site system server object. To obtain a site system server object, use the Get-CMSiteSystemServer cmdlet.

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

Specifies a server name for the site system.

Type:String
Aliases:Name, ServerName
Required:True
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
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

Indicates that wildcard handling is disabled.

Type:SwitchParameter
Required:False
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

Indicates that wildcard handling is enabled.

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

Specifies a site code of a Configuration Manager site.

Type:String
Required:False
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
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False