Move-SCVirtualHardDisk

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

仮想ハード ディスク ファイルを同じホスト上のある場所から別の場所に移動するか、Move-SCVirtualMachine で使用する場合は別のホスト上の場所に移動します。

構文

Move-SCVirtualHardDisk
    [-VMMServer <ServerConnection>]
    -Bus <Byte>
    -LUN <Byte>
    [-SCSI]
    -JobGroup <Guid>
    -Path <String>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]
Move-SCVirtualHardDisk
    [-VMMServer <ServerConnection>]
    -Bus <Byte>
    -LUN <Byte>
    [-IDE]
    -JobGroup <Guid>
    -Path <String>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]
Move-SCVirtualHardDisk
    [-VirtualHardDisk] <StandaloneVirtualHardDisk>
    [-JobGroup <Guid>]
    -Path <String>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

説明

Move-SCVirtualHardDisk コマンドレットは、Windows ベースの仮想ハード ディスク ファイル (.vhd ファイル) または VMware ベースの仮想ハード ディスク ファイル (.vmdk ファイル) を同じホスト上の別の場所に移動します。 Move-SCVirtualHardDisk と Move-SCVirtualMachine コマンドレットを使用して、仮想ハード ディスク ファイルを別のホスト上の場所に移動することもできます。

このコマンドレットを使用して、次のタスクを実行できます。

  • サービスの中断なしで、実行中の VMware 仮想マシン上の仮想ハード ディスクを移動します。

  • サービスの中断を最小限に抑えながら、実行中の Windows Server 2008 R2、Windows Server 2012、またはWindows Server 2016仮想マシン上の仮想ハード ディスクを移動します。 この場合は、 Move-SCVirtualMachine と共に Move-SCVirtualHardDisk を使用します。

  • 仮想マシンが停止状態または保存状態の場合は、任意の種類のホスト上の仮想マシン上の仮想ハード ディスクを移動します。 この場合は、 Set-SCVirtualMachine と共に Move-SCVirtualHardDisk を使用します。 このオプションは、次のいずれかの条件に該当する場合にサポートされます。

-- 仮想マシンは、Windows Server 2008 R2、Windows Server 2012、Windows Server 2016 Hyper-V テクノロジを使用するホスト、または VMware ESX ホスト上にあり、仮想マシンが保存された状態または停止状態にあります。

-- 仮想マシンは、他のサポートされているホスト上にあり、停止状態です。

使用例:

  • ホストに複数の物理ディスク ドライブがあり、仮想マシンに 2 つの仮想ハード ディスクがある場合 (1 つのディスクにオペレーティング システムが含まれている可能性があり、もう 1 つのディスクにデータが含まれている可能性があります)、両方の仮想ハード ディスクのパフォーマンスを向上させるために、このコマンドレットを使用して仮想ハード ディスクの 1 つを別の物理ハード ドライブに移動できます。

  • 仮想マシンに動的に拡張されている仮想ハード ディスクが 1 つあり、仮想ハード ディスクがホスト上の現在の物理ハード ディスク上の領域の大部分を使用するポイントに拡張されている場合は、このコマンドレットを使用して、拡張された仮想ハード ディスクをホスト上で使用可能な場合は、拡張された仮想ハード ディスクを大きな物理ハード ディスクに移動できます。

例

例 1: 同じホスト上のある場所から別の場所に仮想ハード ディスク ファイルを移動する

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $VHD = $VM.VirtualHardDisks[0]
PS C:\> Move-SCVirtualHardDisk -VirtualHardDisk $VHD -Path "C:\VHDs"

最初のコマンドは、VM01 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。

2 番目のコマンドは、VM01 上の最初の仮想ハード ディスク オブジェクトを $VHD 変数に格納します。

最後のコマンドは、$VHDに格納されている仮想ハード ディスクを既存のフォルダー "C:\VHD" に移動します。

パラメーター

-Bus

仮想ディスク ドライブやバーチャル DVD ドライブの接続先となる IDE バス、または仮想ディスク ドライブの接続先となる SCSI バスを指定します。

Type:Byte
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-IDE

仮想マシンまたはテンプレート上に構成される仮想ディスク ドライブ オブジェクトや仮想 DVD ドライブ オブジェクトの接続先となるバスの種類として IDE を指定します。

形式の例: -IDE -Bus 0 -LUN 1

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JobGroup

同じジョブ グループ識別子を含む最後のコマンドが実行される直前に一括して実行される、一連のコマンドの識別子を指定します。

Type:Guid
Position:Named
Default value:None
Required:True
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

-LUN

仮想ディスク ドライブ オブジェクトまたは IDE バス上の仮想 DVD ドライブ オブジェクト、または SCSI バス上の仮想ディスク ドライブ オブジェクトの論理ユニット番号 (LUN) を指定します。

  • 形式の例: -IDE -Bus 1 -LUN 0
  • 形式の例: -SCSI -Bus 0 -LUN 1
Type:Byte
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Path

この操作の宛先パスを指定します。

形式の例:

  • ローカル パス: -Path "F:\"
  • UNC パス: -Path "\\Library\Templates"
  • ボリューム GUID パス: -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
  • VMware ESX パス: -Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
  • Citrix XenServer パス: -Path "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
Type:String
Position:Named
Default value:None
Required:True
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

-SCSI

仮想マシンまたはテンプレート上に構成される仮想ディスク ドライブ オブジェクトの接続先となるバスの種類として SCSI を指定します。

形式の例: -SCSI -Bus 0 -LUN 0

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VirtualHardDisk

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

Type:StandaloneVirtualHardDisk
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

VMM サーバー オブジェクトを指定します。

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

出力

VirtualHardDisk

このコマンドレットは VirtualHardDisk オブジェクトを返します。