Remove-CMStateMigrationPoint

[アーティクル]
11/16/2015

Remove-CMStateMigrationPoint

Removes a state migration point from a Configuration Manager site.

構文

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

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

詳細説明

The Remove-CMStateMigrationPoint cmdlet removes a state migration point from a Microsoft System Center 2012 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 2012 Configuration Manager site.

パラメーター

-Force

Performs the action without a confirmation message.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-InputObject<IResultObject>

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

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-SiteCode<String>

Specifies a site code for a Configuration Manager site.

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-SiteSystemServerName<String>

Specifies the host name for a state migration point.

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

必須?	false
位置は?	named
既定値	false
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

必須?	false
位置は?	named
既定値	false
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

例

Example 1: Remove a specified migration point

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.

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

Example 2: Remove a migration point using a variable

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.

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

Remove-CMStateMigrationPoint