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
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-JobGroup
同じジョブ グループ識別子を含む最後のコマンドが実行される直前にセットとして実行される一連のコマンドの識別子を指定します。
型: | Guid |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OnBehalfOfUser
ユーザーの名前を指定します。 このコマンドレットは、このパラメーターが指定するユーザーとしてユーザーの代理を設定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 このコマンドレットは、このパラメーターが指定するユーザー ロールとしてユーザー ロールの代理を設定します。 ユーザー ロール オブジェクトを取得するには、Get-SCUserRole コマンドレットを使用します。
型: | UserRole |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
型: | Guid |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VMCheckpoint
VMM 仮想マシンチェックポイント オブジェクトを指定します。
型: | VMCheckpoint |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
メモ
- Get-SCVMCheckpoint コマンドレットを使用して取得できる VMM チェックポイント オブジェクトが必要です。