Remove-SCVirtualHardDisk
仮想マシンまたはテンプレート、または VMM ライブラリから仮想ハード ディスク オブジェクトを削除します。
構文
Remove-SCVirtualHardDisk
[-VirtualHardDisk] <VirtualHardDisk>
[-JobGroup <Guid>]
[-Force]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
Remove-SCVirtualHardDisk コマンドレットは、仮想マシンまたはテンプレート、または仮想マシン マネージャー (VMM) ライブラリから仮想ハード ディスク オブジェクトを削除します。 Remove-VirtualHardDisk は、対応する仮想ハード ディスク ファイル (Windows ベースの .vhd ファイル、Citrix XenServer ベースの .vhd ファイル、または VMware ベースの .vmdk ファイル) もライブラリ サーバーから削除します。
仮想ハード ディスクが仮想マシンまたはテンプレート上の仮想ディスク ドライブに接続されている場合 (また、Force パラメーターを使用しない場合)、仮想ハード ディスクを含むコンテナーが VMM に一覧表示され、仮想ハード ディスクを削除するかどうかを確認するメッセージが表示されます。
[はい] と応答すると、VMM は仮想ハード ディスクと仮想ハード ディスクが接続されているコンテナーの間の関連付けを削除し、VMM から仮想ハード ディスク オブジェクトを削除します。
「いいえ」と返信すると、操作は取り消されます。
このコマンドレットは、成功した場合 (MarkedForDeletion プロパティが True に設定されている) オブジェクトを返すか、失敗した場合にエラー メッセージを返します。
例
例 1: ライブラリから仮想ハード ディスク オブジェクトを削除する
PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "VHD01.vhd" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }
PS C:\> Remove-SCVirtualHardDisk -VirtualHardDisk $VHD最初のコマンドは、LibraryServer01 に格納されている VHD01.vhd という名前の仮想ハード ディスク オブジェクトを取得し、返されたオブジェクトを$VHD変数に格納します。
2 番目のコマンドは、$VHDに格納されている仮想ハード ディスク オブジェクトをライブラリから削除し、対応するファイルをライブラリ サーバー上のファイル システムから削除します。
例 2: 仮想マシンから仮想ハード ディスクを削除する
PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $VHD = Get-SCVirtualMachine -Name "VM01" | Get-SCVirtualHardDisk | where { $_.Name -match "DataDisk" }
PS C:\> $VHD | Remove-SCVirtualHardDisk最初のコマンドは VMMServer01 に接続します。
2 番目のコマンドは、VM01 という名前の仮想マシン オブジェクトを取得し、名前に "DataDisk" という文字列が含まれる VM01 上のすべての仮想ハード ディスクを取得し、これらの仮想ハード ディスク オブジェクトを $VHD という名前の配列に格納します。
3 番目のコマンドは、$VHD アレイに格納されている各仮想ハード ディスク オブジェクトを仮想マシンから削除し、対応する各ファイルをライブラリ サーバー上のファイル システムから削除します。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Force
ユーザーの確認を求めずにコマンドを強制的に実行します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobGroup
同じジョブ グループ識別子を含む最後のコマンドが実行される直前にセットとして実行される一連のコマンドの識別子を指定します。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VirtualHardDisk
仮想ハード ディスク オブジェクトを指定します。
| 型: | VirtualHardDisk |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
メモ
- Get-SCVirtualHardDisk コマンドレットを使用して取得できる VMM 仮想ハード ディスク オブジェクトが必要です。