Remove-SCVirtualHardDisk

  • リファレンス
モジュール:
VirtualMachineManager

仮想マシンまたはテンプレート、または 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

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

ユーザーに確認せずに、直ちにコマンドを実行します。

Type:SwitchParameter
Position:Named
Default value:None
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

-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

-VirtualHardDisk

バーチャル ハード ディスク オブジェクトを指定します。

Type:VirtualHardDisk
Position:0
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-SCVirtualHardDisk コマンドレットを使用して取得できる VMM 仮想ハード ディスク オブジェクトが必要です。