Remove-CMStateMigrationPoint

Removes a state migration point from a Configuration Manager site.

Syntax

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

Description

The Remove-CMStateMigrationPoint cmdlet removes a state migration point from a Microsoft System Center Configuration Manager site. This site system role stores user information while you perform an operating system deployment. If you remove a state migration point, you also remove all associated stored user information.

Each state migration point can be a member of only one System Center Configuration Manager site.

Examples

Example 1: Remove a specified migration point

PS C:\> Remove-CMStateMigrationPoint -SiteCode "CM1" -SiteSystemServerName "SMP01.Western.Contoso.com"

This command removes a state migration point that belongs to the site that has the site code CM1. The command specifies the name of computer that hosts the site system role.

Example 2: Remove a migration point using a variable

PS C:\> $CMSMP = Get-CMStateMigrationPoint -SiteCode "CM1" -SiteSystemServerName "SMP01.TSQA.Contoso.com"
PS C:\> Remove-CMStateMigrationPoint -InputObject $CMSMP

The first command uses the Get-CMStateMigrationPoint to get a state migration point that belongs to the specified site and has the specified host name, and then stores that object in the $CMSMP variable.

The second command removes the state migration point stored in the $CMSMP variable.

Required Parameters

-InputObject

Specifies a state migration point object. To obtain a state migration point object, use the Get-CMStateMigrationPoint cmdlet.

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

Specifies the host name for a state migration point.

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