Save-SCVirtualMachine

構文

Save-SCVirtualMachine
    [-VM] <VM>
    [-LibraryServer <LibraryServer>]
    [-UseLAN]
    [-SharePath <String>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

説明

Save-SCVirtualMachine コマンドレットは、ホストにデプロイされた仮想マシンを仮想マシン マネージャー (VMM) ライブラリに移行します。

これにより、次のいずれかの転送方法を使用して、VMM ライブラリに仮想マシンが格納されます。

• SAN 転送 (ファイバー チャネル、iSCSI、または NPIV)。 ホスト サーバーとライブラリ サーバーの両方が SAN ストレージに接続されている場合、VMM は SAN 転送を使用して仮想マシンをライブラリに格納できます。 SAN 転送では、転送元のホストから転送先のライブラリ サーバーにターゲット LUN が再マップされます。 このコマンドレットは、ファイルを移動しません。 SAN 転送は、仮想マシン ファイルをローカル エリア ネットワーク (LAN) 経由でホスト間で移動するよりもはるかに高速です。 NPIV でのホスト バス アダプタ (HBA) がサポートされる場合、VMM では NPIV SAN 転送を使用できます。
• ネットワーク転送。 高速な方法がない場合、VMM はネットワーク転送を使用して、2 つのサーバーを接続する LAN 経由でホスト サーバーからライブラリ サーバーに仮想マシン ファイルを移動します。 SharePath パラメーターとして仮想マシンを格納するライブラリ内の 共有 のパスを指定します。

このコマンドレットは、最も高速に利用可能な転送の種類を自動的に使用します。 ネットワーク転送を強制する場合は、 UseLAN パラメーターを指定します。 ホスト サーバーとライブラリ サーバーが同じサーバーの場合、 UseLAN を指定してもコマンドは失敗しませんが、そのパラメーターを使用しないと、ライブラリへの移行が高速になります。

仮想マシンは、ライブラリに保管しただけでは起動できません。 仮想マシンを起動する前に、 Move-SCVirtualMachine コマンドレットを使用して仮想マシンをホストに移動する必要があります。

例

例 1: 仮想マシンをライブラリに保存する

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $LibServer = Get-SCLibraryServer -ComputerName "LibServer01"
PS C:\> Save-SCVirtualMachine -LibraryServer $LibServer -VM $VM -SharePath "\\LibServer01.Contoso.com\Library01\VMs"

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

2 番目のコマンドは LibServer01 という名前のライブラリ サーバー オブジェクトを取得し、そのオブジェクトを $Library 変数に格納します。

最後のコマンドは、VM01 をホストから移行し、それを場所 \LibServer01.Contoso.com\Library01\VM に格納します。 このコマンドは、使用可能な転送方法のうちで最も迅速な方法を自動的に使用します。

例 2: ライブラリに仮想マシンを非同期的に格納する

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $LibServer = Get-SCLibraryServer -ComputerName "LibServer02"
PS C:\> Save-SCVirtualMachine -LibraryServer $LibServer -VM $VM -SharePath "\\LibServer02.Contoso.com\Library02\VMs" -RunAsynchronously -JobVariable "SaveVMJob"
PS C:\> $SaveVMJob

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

2 番目のコマンドは LibServer02 という名前のライブラリ サーバー オブジェクトを取得し、そのオブジェクトを $Library 変数に格納します。

3 番目のコマンドは、VM02 を場所 \LibServer02.Contoso.com\Library02\VM に移行します。 コマンドは、コマンド シェルにコントロールをすぐに返す RunAsynchronously パラメーターを指定します。 このコマンドは、ジョブの進行状況を追跡する JobVariable パラメーターを指定し、その進行状況のレコードを$SaveVMJobに格納します。 JobVariable の場合、変数を作成するドル記号 ($) は指定しません。

最後のコマンドは、$SaveVMJobの内容を表示します。

例 3: ネットワーク転送を強制して、ライブラリに仮想マシンを格納する

PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> $LibServer = Get-SCLibraryServer -ComputerName "LibServer01"
PS C:\> Save-SCVirtualMachine -LibraryServer $LibServer -VM $VM -SharePath "\\LibServer01.Contoso.com\Library01\VMs" -UseLAN

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

2 番目のコマンドは、LibServer01 という名前のライブラリ サーバー オブジェクトを取得し、そのオブジェクトを$LibServer変数に格納します。

最後のコマンドは、VM03 を場所 \LibServer01.Contoso.com\Library01\VM に格納します。 UseLAN パラメーターは、高速転送メカニズムが使用可能な場合でも、LAN 経由でネットワーク転送を強制します。

パラメーター

-JobVariable

-LibraryServer

-OnBehalfOfUser

-OnBehalfOfUserRole

-PROTipID

-RunAsynchronously

-SharePath

-UseLAN

-VM

出力

VirtualMachine

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

メモ

• Get-SCVirtualMachine コマンドレットを使用して取得できる VMM 仮想マシン オブジェクトが必要です。

関連リンク

• Get-SCUserRole
• Get-SCVirtualMachine
• Move-SCVirtualMachine
• Read-SCVirtualMachine
• Stop-SCVirtualMachine