System Center 2016 – Virtual Machine Manager (SCVMM 2016) に触れる機会が多くなり、Virtual Machine Manager Command Shell を使った設定や、情報取得、および管理することが増えてきたので、備忘録として各コマンドレットの概要を日本語化 (意訳) しました。
ここでは Register-SCVirtualMachine コマンドレットのヘルプ情報について、SCVMM2016 UR5 の Virtual Machine Manager Command Shell 上で「Register-SCVirtualMachine」コマンドレットの -Full オプションを用いて実行した結果を元に記載しています。
※SCVMM 2016 UR5 で利用可能なコマンドレット一覧については、「System Center 2016 – Virtual Machine Manager で利用できるコマンドレットについて」を参照。
Register-SCVirtualMachine コマンドレット
名前
Register-SCVirtualMachine
概要
現在 VMM によって管理されている任意のホストの仮想化プラットフォームを登録していない、および VMM ライブラリに格納されていない既存の仮想マシンを VMM に登録します。
構文
Register-SCVirtualMachine [-Path] <String> [-VMHost] <Host> [-JobGroup <Guid>] [-JobVariable <String>] [-PROTipID <Guid>] [-RunAsynchronously] [<CommonParameters>] |
説明
Register-SCVirtualMachine コマンドレットは、既存の仮想マシンを Virtual Machine Manager (VMM) に登録します。VMM によって管理され、VMM ライブラリに格納されていないホストの仮想化プラットフォームに現在登録されていないホストを登録します。仮想化プラットフォームは、Hyper-V、VMware、および XenServer です。仮想マシン ファイルが VMM ライブラリに格納されている場合、仮想マシンをホストに展開する前に登録する必要はありません。
登録する仮想マシンの構成ファイルは、仮想マシンを展開するホスト上のファイル システムに格納するか、このホストで使用できる共有記憶域に格納する必要があります。
Hyper-V ホスト用の仮想マシンを登録するには、その仮想マシンの構成ファイルをホストのファイル システム上のフォルダー、もしくは共有記憶域に保存する必要があります。さらに、Hyper-V マネージャー コンソールで [エクスポート] コマンドを使用して、仮想マシンのエクスポートを作成する必要があります。パスにはフォルダーを指定する必要があります。
VMware ESX ホスト用の仮想マシンを登録するには、VMware 構成 .vmx をホストのファイル システム、もしくは共有記憶域に保存する必要があります。別のエクスポート手順はありません。パスでは、フォルダーと構成ファイルを指定する必要があります。
このコマンドレットを使用して、XenServer ホストに仮想マシンを登録しないでください。
パラメーター
-JobGroup <Guid>
同じジョブ グループ識別子を含む最後のコマンドが実行される直前に、一連のコマンドを実行する一連のコマンドの識別子を指定します。
必須 | false |
---|---|
位置 | named |
既定値 | None |
パイプライン入力を許可する | False |
ワイルドカード文字を許可する | false |
-JobVariable <String>
ジョブの進行状況を追跡、および格納する変数名を指定します。
必須 | false |
---|---|
位置 | named |
既定値 | None |
パイプライン入力を許可する | False |
ワイルドカード文字を許可する | false |
-PROTipID <Guid>
このアクションにトリガーされるパフォーマンスとリソースの最適化のヒント (PRO ヒント) を指定します。このパラメーターは、PRO ヒントを監査することができます。
必須 | false |
---|---|
位置 | named |
既定値 | None |
パイプライン入力を許可する | False |
ワイルドカード文字を許可する | false |
-Path <String>
このコマンドレットが登録する仮想マシンの仮想マシン構成ファイルのパスを指定します。
必須 | true |
---|---|
位置 | 0 |
既定値 | None |
パイプライン入力を許可する | False |
ワイルドカード文字を許可する | false |
-RunAsynchronously [<SwitchParameter>]
ジョブが非同期で実行、制御がすぐにコマンド シェルに戻されるかどうかを指定します。
必須 | false |
---|---|
位置 | named |
既定値 | False |
パイプライン入力を許可する | False |
ワイルドカード文字を許可する | false |
-VMHost <Host>
仮想マシン ホスト オブジェクトを指定します。VMM は、Hyper-V ホスト、VMware ESX ホスト、および Citrix XenServer ホストをサポートします。
各ホストの種類に関する情報について、Add-SCVMHost コマンドレットを参照してください。
必須 | true |
---|---|
位置 | 0 |
既定値 | None |
パイプライン入力を許可する | True (ByValue) |
ワイルドカード文字を許可する | false |
<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer, PipelineVariable、および OutVariable。詳細については、about_CommonParameters を参照してください。
入力
出力
- VirtualMachine
メモ
例
例 1 : 既存の仮想マシンを Hyper-V ホストに登録する
コマンド
$VMHost = Get-SCVMHost -ComputerName "HyperVHost01" Register-SCVirtualMachine -VMHost $VMHost -Path "D:\HyperVFolderForVMs"
コマンドの説明
最初のコマンドは、Hyper-V ホスト オブジェクト “HyperVHost01” を取得し、そのオブジェクトを $VMHost 変数に格納します。
2 番目のコマンドは、仮想マシン構成ファイルが格納されているフォルダーのパスを指定することで、HVHost02 上の既存の仮想マシンを VMM に追加します。
例 2 : 既存の仮想マシンを VMware ESX ホストに登録する
コマンド
$VMHost = Get-VMHost -ComputerName "ESXHost03" Register-SCVirtualMachine -VMHost $VMHost -Path "[storage1]\VMwareFolderForVMs\MyVM.vmx"
コマンドの説明
最初のコマンドは、Mware ESX ホストを表すオブジェクト “ESXHost03” を取得し、そのホスト オブジェクトを $VMHost 変数に格納します。
2 番目のコマンドは、仮想マシンの仮想マシン構成ファイルのパスを指定して、ESXHost03 上の既存の仮想マシンを VMM に追加します。
関連するリンク
- Add-SCVMHost
- Get-SCVirtualMachine
- Get-SCVMHost
- Move-SCVirtualMachine
- New-SCVirtualMachine
- Read-SCVirtualMachine
- Remove-SCVirtualMachine
- Repair-SCVirtualMachine
- Resume-SCVirtualMachine
- Save-SCVirtualMachine
- Set-SCVirtualMachine
- Start-SCVirtualMachine
- Stop-SCVirtualMachine
- Suspend-SCVirtualMachine
参考
- System Center 2016 – データセンターの管理 | Microsoft
https://www.microsoft.com/ja-jp/cloud-platform/system-center - VirtualMachineManager | Microsoft Docs
https://docs.microsoft.com/en-us/powershell/module/virtualmachinemanager/?view=systemcenter-ps-2016 - Register-SCVirtualMachine (VirtualMachineManager) | Microsoft Docs
https://docs.microsoft.com/en-us/powershell/module/virtualmachinemanager/register-scvirtualmachine?view=systemcenter-ps-2016