Register-SCVirtualMachine
VMM で管理されているホストの仮想化プラットフォームに現在登録されておらず、VMM ライブラリに格納されていない既存の仮想マシンを VMM に登録します。
構文
Register-SCVirtualMachine
[-VMHost] <Host>
[-Path] <String>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
説明
Register-SCVirtualMachine コマンドレットは、既存の仮想マシンを Virtual Machine Manager (VMM) に登録します。 VMM によって管理されているホストの仮想化プラットフォームに現在登録されておらず、VMM ライブラリに格納されていないホストを登録します。 仮想化プラットフォームは、Hyper-V、VMware、XenServer です。 仮想マシン ファイルが VMM ライブラリに格納されている場合は、ホストに展開する前に仮想マシンを登録する必要はありません。
登録する仮想マシンの構成ファイルは、仮想マシンをデプロイするホスト上のファイル システムに格納するか、このホストで使用できる共有ストレージに格納する必要があります。
Hyper-V ホストの仮想マシンを登録するには、その仮想マシンの構成ファイルを、ホストのファイル システム上または共有ストレージ上のフォルダーに格納する必要があります。 さらに、Hyper-V マネージャー コンソールの [エクスポート] コマンドを使用して、仮想マシンのエクスポートを作成する必要があります。 パスにはフォルダの指定が必要です。
VMware ESX ホストの仮想マシンを登録するには、VMware 構成 .vmx をホストのファイル システムまたは共有ストレージに格納する必要があります。 別のエクスポート手順はありません。 パスによって、フォルダと構成ファイルを指定する必要があります。
このコマンドレットを使用して、XenServer ホストに仮想マシンを登録しないでください。
例
例 1: Hyper-V ホストに既存の仮想マシンを登録する
PS C:\> $VMHost = Get-SCVMHost -ComputerName "HyperVHost01"
PS C:\> Register-SCVirtualMachine -VMHost $VMHost -Path "D:\HyperVFolderForVMs"
最初のコマンドは、HyperVHost01 という名前の Hyper-V ホスト オブジェクトを取得し、そのオブジェクトを$VMHost変数に格納します。
2 番目のコマンドでは、仮想マシン構成ファイルを含むフォルダーのパスを指定して、HVHost02 上の既存の仮想マシンを VMM に追加します。
例 2: VMware ESX ホストに既存の仮想マシンを登録する
PS C:\> $VMHost = Get-VMHost -ComputerName "ESXHost03"
PS C:\> Register-SCVirtualMachine -VMHost $VMHost -Path "[storage1]\VMwareFolderForVMs\MyVM.vmx"
最初のコマンドは、ESXHost03 という VMware ESX ホストを表すオブジェクトを取得し、そのホスト オブジェクトを$VMHost変数に格納します。
2 番目のコマンドでは、仮想マシンの仮想マシン構成ファイルのパスを指定して、ESXHost03 上の既存の仮想マシンを VMM に追加します。
パラメーター
-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 |
-Path
このコマンドレットが登録する仮想マシンの仮想マシン構成ファイルのパスを指定します。
Type: | String |
Position: | 0 |
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 |
-VMHost
仮想マシン ホスト オブジェクトを指定します。 VMM では、Hyper-V ホスト、VMware ESX ホスト、Citrix XenServer ホストがサポートされます。
各種類のホストの詳細については、 Add-SCVMHost コマンドレットを参照してください。
Type: | Host |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
出力
VirtualMachine