Remove-SCVMCheckpoint

Remove-SCVMCheckpoint

Removes a virtual machine checkpoint object from the VMM database.

構文

Parameter Set: Default
Remove-SCVMCheckpoint -VMCheckpoint <VMCheckpoint> [-JobGroup <Guid> ] [-JobVariable <String> ] [-PROTipID <Guid> ] [-RunAsynchronously] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Remove-SCVMCheckpoint cmdlet removes a virtual machine checkpoint object from the Virtual Machine Manager (VMM) database.

パラメーター

-JobGroup<Guid>

Specifies an identifier for a series of commands that will run as a set just before the final command that includes the same job group identifier runs.

-JobVariable<String>

Specifies that job progress is tracked and stored in the variable named by this parameter.

-PROTipID<Guid>

Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

-RunAsynchronously

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

-VMCheckpoint<VMCheckpoint>

Specifies a VMM virtual machine checkpoint object.

-Confirm

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

-WhatIf

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

<CommonParameters>

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

入力

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

出力

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

注

• This cmdlet requires a VMM checkpoint object, which can be retrieved by using the Get-SCVMCheckpoint cmdlet.

例

Example Example 1: Remove the most recent checkpoint for a virtual machine.

The first command gets all checkpoint objects for VM01, and then stores these objects in the $Checkpoints object array. This example assumes that VM01 has several checkpoints.

The second command removes the first checkpoint in the array, $Checkpoints[0]. The Confirm parameter prompts you to confirm whether you want to remove the checkpoint.

PS C:\> $Checkpoint = Get-VMCheckpoint -VM "VM01" -MostRecent
PS C:\> Remove-SCVMCheckpoint -VMCheckpoint $Checkpoint -Confirm

Example 2: Remove a specified checkpoint for a virtual machine

The first command gets all checkpoint objects for VM01, and stores the objects in the $Checkpoints object array. This example assumes that VM01 has at least two checkpoints.

The second command removes the first checkpoint stored in the $Checkpoints array, which is the first checkpoint created for VM01. The command prompts you for confirmation before proceeding.

PS C:\> $Checkpoints = Get-VMCheckpoint -VM "VM01"
PS C:\> Remove-VMCheckpoint -VMCheckpoint $Checkpoints[0] -Confirm

関連トピック

Get-SCVMCheckpoint

New-SCVMCheckpoint

Restore-SCVMCheckpoint

Set-SCVMCheckpoint