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
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| 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 仮想ハード ディスク オブジェクトが必要です。