Remove-SCVirtualHardDisk

Remove-SCVirtualHardDisk
    [-VirtualHardDisk] <VirtualHardDisk>
    [-JobGroup <Guid>]
    [-Force]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Remove-SCVirtualHardDisk コマンドレットは、仮想マシンまたはテンプレート、あるいは Virtual Machine Manager (VMM) ライブラリから仮想ハード ディスク オブジェクトを削除します。 Remove-VirtualHardDisk は、対応する仮想ハード ディスク ファイル (Windows ベースの .vhd ファイル、Citrix XenServer ベースの .vhd ファイル、または VMware ベースの .vmdk ファイル) もライブラリ サーバーから削除します。

バーチャル ハード ディスクがバーチャル マシンまたはテンプレート上の仮想ディスク ドライブに接続されている場合 (および Force パラメーターを使用しない場合)、VMM はバーチャル ハード ディスクを含むコンテナーを一覧表示し、バーチャル ハード ディスクを削除することを確認するように求めます。

• [はい] と応答すると、VMM は仮想ハード ディスクとそれが接続されているコンテナーとの関連付けを削除し、VMM から仮想ハード ディスク オブジェクトを削除します。

• 「いいえ」と答えると、操作はキャンセルされます。

このコマンドレットは、成功した場合 (MarkedForDeletion プロパティが True に設定された) にオブジェクトを返すか、失敗した場合にエラー メッセージを返します。

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 に格納されている仮想ハード ディスク オブジェクトをライブラリから削除し、対応するファイルをライブラリ サーバー上のファイル システムから削除します。

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 配列に格納されている各仮想ハード ディスク オブジェクトを仮想マシンから削除し、ライブラリ サーバー上のファイル システムから対応する各ファイルを削除します。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

• VMM 仮想ハード ディスク オブジェクトが必要です。このオブジェクトは、 Get-SCVirtualHardDisk コマンドレットを使用して取得できます。