Export (0) Print
Expand All
Expand Minimize

Remove-CMManagementPoint

Updated: September 1, 2013

Applies To: System Center 2012 Configuration Manager SP1

Remove-CMManagementPoint

Removes a management point.

Syntax

Parameter Set: SearchByNameMandatory
Remove-CMManagementPoint -SiteCode <String> -SiteSystemServerName <String> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByValueMandatory
Remove-CMManagementPoint -InputObject <IResultObject> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]




Detailed Description

The Remove-CMManagementPoint cmdlet removes a management point. A management point is a site system role that provides policy and service location information to clients and receives configuration data from clients.

When you remove a management point, Microsoft System Center 2012 Configuration Manager disables communication between the site server and the clients that you assigned to the site server. System Center 2012 Configuration Manager cannot provide these clients with installation prerequisites, client installation files, configuration details, advertisements, and software distribution package source file locations. Additionally, System Center 2012 Configuration Manager cannot receive inventory data, software metering information, and status and state messages from the clients.

Parameters

-Force

Removes the management 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 CMManagementPoint object. To obtain a CMManagementPoint object, use the Get-CMManagementPoint cmdlet.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SiteCode<String>

Specifies the site code of the Configuration Manager site that hosts the site system role.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SiteSystemServerName<String>

Specifies the fully qualified domain name (FQDN) of the server that hosts the 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 executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.


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.

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 management point

This command removes the management point from the Configuration Manager site that has the site code Cm1 on the site system named cmcen-dist02.tsqa.contoso.com.


PS C:\> Remove-CMManagementPoint -SiteSystemName "cmcen-dist02.tsqa.contoso.com" -SiteCode "Cm1"

Example 2: Remove a management point by using an object variable

The first command gets the management point from the Configuration Manager site that has the site code Cm1 on the site system named dist02.tsqa.contoso.com. The command stores the results in the $Mp variable.

The second command removes the management point stored in the $Mp variable.


PS C:\> $Mp = Get-CMManagementPoint -SiteSystemName "dist02.tsqa.contoso.com" -SiteCode "Cm1"
PS C:\> Remove-CMManagementPoint -InputObject $Mp

Related topics

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft