次の方法で共有


Remove-SCVMCheckpoint

VMM データベースから仮想マシン チェックポイント オブジェクトを削除します。

構文

Remove-SCVMCheckpoint
      -VMCheckpoint <VMCheckpoint>
      [-JobGroup <Guid>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

説明

Remove-SCVMCheckpoint コマンドレットは、仮想マシン マネージャー (VMM) データベースから仮想マシン チェックポイント オブジェクトを削除します。

例 1: 仮想マシンの最新のチェックポイントを削除する

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

最初のコマンドは、VM01 のすべてのチェックポイント オブジェクトを取得し、これらのオブジェクトを $Checkpoints オブジェクト配列に格納します。 この例では、VM01 に複数のチェックポイントが存在することを前提としています。

2 番目のコマンドは、配列内の最初のチェックポイントを削除します ($Checkpoints[0])。 Confirm パラメーターでは、チェックポイントを削除するかどうかを確認するメッセージが表示されます。

例 2: 仮想マシンの指定されたチェックポイントを削除する

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

最初のコマンドは、VM01 のすべてのチェックポイント オブジェクトを取得し、$Checkpoints オブジェクト配列にオブジェクトを格納します。 この例では、VM01 に少なくとも 2 つのチェックポイントがあることを前提としています。

2 番目のコマンドは、VM01 用に作成された最初のチェックポイントである、$Checkpoints 配列に格納されている最初のチェックポイントを削除します。 続行する前に、確認を求めるメッセージが表示されます。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobGroup

同じジョブ グループ識別子を含む最後のコマンドが実行される直前に一括して実行される、一連のコマンドの識別子を指定します。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

ユーザーの名前を指定します。 このコマンドレットは、このパラメーターが指定するユーザーとしてユーザーの代理を設定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

ユーザー ロールを指定します。 このコマンドレットは、このパラメーターが指定するユーザー ロールとしてユーザー ロールの代理を設定します。 ユーザー ロール オブジェクトを取得するには、 Get-SCUserRole コマンドレットを 使用します。

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

このアクションをトリガーしたパフォーマンスとリソース最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

コントロールがコマンド シェルに直ちに戻るように、ジョブが非同期的に実行されることを示します。

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

-VMCheckpoint

VMM 仮想マシン チェックポイント オブジェクトを指定します。

Type:VMCheckpoint
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

メモ

  • Get-SCVMCheckpoint コマンドレットを使用して取得できる VMM チェックポイント オブジェクトが必要です。