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 チェックポイント オブジェクトが必要です。