Remove-SCVirtualMachine
VMM から仮想マシン オブジェクトを削除します。
構文
Remove-SCVirtualMachine
[-VM] <VM>
[-SkipFileRemoval]
[-Force]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] 説明
Remove-SCVirtualMachine コマンドレットは、ホストに展開されているか、仮想マシン マネージャー (VMM) ライブラリ サーバーに格納されている仮想マシン オブジェクトを削除します。
このコマンドレットは、VMM データベースから仮想マシン レコードを削除し、仮想マシンに関連付けられているすべてのファイルを削除し、展開先のホストまたは仮想マシンが格納されているライブラリ サーバーから仮想マシンを削除します。
ホスト上のフォルダーが、Hyper-V または VMware ではなく VMM によってこの仮想マシン用に作成され、そのフォルダーに他の仮想マシンまたはその他のデータが含まれなかった場合は、仮想マシンを削除した後でファイル システムを使用してフォルダーを削除できます。
Force パラメーターを指定した場合、このコマンドレットは VMM データベースから仮想マシンのみを削除します。 仮想マシン自体は削除されません。
このコマンドレットは、MarkedForDeletion プロパティの値が$Trueの成功時にオブジェクトを返します。 失敗した場合、コマンドレットはエラー メッセージを返します。
例
例 1: ホストにデプロイされている特定の仮想マシンを削除する
PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.VMHost.Name -eq "VMHost01.Contoso.com" -and $_.Name -eq "VM01" }
PS C:\> Remove-SCVirtualMachine -VM $VM最初のコマンドは、VMHost01 にデプロイされた VM01 という名前の仮想マシン オブジェクトを取得し、その仮想マシン オブジェクトを $VM 変数に格納します。
2 番目のコマンドは、$VMに格納されているオブジェクトを削除し、対応する仮想マシン ファイルをホスト上のファイル システムから削除します。
例 2: 特定の文字列を含む名前を持つすべての仮想マシンを削除する
PS C:\> $VMs = @(Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -Match "VM0" } )
PS C:\> $VMs | Remove-SCVirtualMachine最初のコマンドは、名前に文字列 VM0 が含まれる任意のホストにデプロイされているすべての仮想マシン オブジェクトを取得し、これらの仮想マシン オブジェクトを $VMs という名前の配列に格納します。
2 番目のコマンドは、$VMs配列内の各仮想マシン オブジェクトを削除し、対応する仮想マシン ファイルを各ホスト上のファイル システムから削除します。
例 3: VMM ライブラリ サーバーに格納されている特定の仮想マシンを削除する
PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer1.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "VM02" }
PS C:\> Remove-SCVirtualMachine -VM $VM最初のコマンドは、VM03 という名前の仮想マシンを表すオブジェクトを取得し、仮想マシン オブジェクトを$VMに格納します。 この例では、VM03 という名前の仮想マシンが 1 つだけ存在します。
2 番目のコマンドは、VM03 を表すオブジェクトをライブラリから削除し、対応する仮想マシン ファイルをライブラリ サーバー上のファイル システムから削除します。
例 4: VMM ライブラリから複数の格納されている仮想マシンを削除する
PS C:\> $VMs = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -match "VM0" }
PS C:\> $VMs | Remove-SCVirtualMachine -Confirm最初のコマンドは、名前に文字列 VM0 が含まれており、LibraryServer01 に格納されているすべての仮想マシン オブジェクトを取得します。 次に、仮想マシン オブジェクトを $VMs という名前の配列に格納します。
2 番目のコマンドは、$VMsに格納されている各仮想マシン オブジェクトを現在のコマンドレットに渡します。これにより、ライブラリから各オブジェクトが削除され、対応する仮想マシン ファイルがライブラリ サーバー上のファイル システムから削除されます。 Confirm パラメーターを使用すると、これらの各仮想マシンを削除するかどうかを確認するメッセージが表示されます。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Force
このコマンドレットは、VMM データベースから仮想マシンのみを削除することを示します。 仮想マシン自体は削除されません。
手記
サービス テンプレートまたは VMRole を使用してデプロイされた仮想マシンの場合、このパラメーターは無視され、実際の仮想マシンも削除されます。
| 型: | SwitchParameter |
| 配置: | 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 |
-SkipFileRemoval
このコマンドレットは、仮想マシン関連のファイルを直接削除しないことを示します。 このパラメーターを指定した場合、ファイルを直接削除する試みは行われません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VM
仮想マシン オブジェクトを指定します。
| 型: | VM |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
メモ
このコマンドレットには、Get-SCVirtualMachine コマンドレットを使用して取得できる VMM 仮想マシン オブジェクトが必要です。