【 Get-VMNetworkAdapterVlan 】コマンドレット――Hyper-V仮想マシンの仮想ネットワークアダプターのVLAN情報を取得する：Windows PowerShell基本Tips（142）

本連載は、PowerShellコマンドレットについて、基本書式からオプション、具体的な実行例までを紹介していきます。今回は「Get-VMNetworkAdapterVlan」コマンドレットを解説します。

[後藤諭史，株式会社ネットワールド]

連載目次

　本連載では、Windows PowerShellの基本的なコマンドレットについて、基本的な書式からオプション、具体的な実行例までを分かりやすく紹介していきます。今回は、「Hyper-V」の仮想マシンに接続された仮想ネットワークアダプターのVLAN情報を取得する「Get-VMNetworkAdapterVlan」コマンドレットです。

目次

Get-VMNetworkAdapterVlanの概要 | 書式 | オプション

実行例

• 仮想マシンの仮想ネットワークアダプターのVLAN情報を取得する
• ホストOSが使用する仮想ネットワークアダプターを取得する

Get-VMNetworkAdapterVlanコマンドレットとは？

　Hyper-Vの仮想スイッチはさまざまなネットワーク機能を仮想マシンに提供しており、ネットワークを論理的に分割する「VLAN」（Virtual Local Area Network）にも対応しています。

　仮想マシンのゲストOSでVLANを設定した場合は、VLANの設定をそのまま透過して物理ネットワークに送出することもできますし、仮想マシンの外側、すなわちハイパーバイザー側で処理を行って仮想マシンが送出するパケットを特定のVLANに流すこともできます。

　このような処理は物理ネットワークの世界でも当たり前のように行われており、仮想ネットワークの世界でも当然行えます。VLANの処理は仮想スイッチで行われますが、VLAN設定は仮想ネットワークアダプターに対して行われます。

　Get-VMNetworkAdapterVlanは、仮想マシンに接続されている仮想ネットワークアダプターのVLAN情報を取得するコマンドレットです。

　前述の通り、VLAN設定は仮想ネットワークアダプターの設定として行う必要があるため、VLANを使用する物理ネットワークに接続する仮想化基盤を管理する上で非常に重要な役割を果たすため、管理者としては押さえておきたいコマンドレットになります。

【注】Get-VMNetworkAdapterVlanコマンドレットは「Windows PowerShell用Hyper-Vモジュール」に含まれるコマンドレットになります。GUI（グラフィカルユーザーインタフェース）の「Windowsの機能の有効化」や「役割と機能の追加」からHyper-Vを有効化するか、PowerShellから「Enable-WindowsOptionalFeature」コマンドレットを使用して有効化します。

Get-VMNetworkAdapterVlanコマンドレットの書式

Get-VMNetworkAdapterVlan [オプション]

Get-VMNetworkAdapterVlanコマンドレットの主なオプション

オプション	意味
-VMName	仮想マシン名を指定する。省略可能
-VMNetworkAdapterName	仮想ネットワークアダプター名を指定する。省略可能
-ManagementOS	ホストOS用の仮想ネットワークアダプターを取得したい場合に指定する。省略可能
-ComputerName	リモートのHyper-Vホストの仮想ネットワークアダプターのVLAN情報を取得する場合にコンピュータ名を指定する。省略可能

目次に戻る

仮想マシンの仮想ネットワークアダプターのVLAN情報を取得する

　Get-VMNetworkAdapterVlanコマンドレットは必須オプションがないため、オプションを指定せずに実行した場合は、Hyper-Vホスト上にある全ての仮想ネットワークアダプターのVLAN情報を取得します（画面1）。なお、Get-VMNetworkAdapterVlanコマンドレットは管理者権限での実行が必要となります。

コマンドレット実行例

Get-VMNetworkAdapterVlan

画面1　Hyper-Vホスト上にある全ての仮想ネットワークアダプターのVLAN情報を取得した

　コマンドレット実行後は、仮想マシン名と仮想ネットワークアダプター名、そしてVLANのモードとVLAN番号が表示されます。「Mode」では設定されているVLANのモードが表示されており、通常のVLAN設定で使用されるモード（Untagged／Access／Trunk）、プライベートVLANで使用されるモード（Isolated／Community／Promiscuous）といったVLANモードのいずれかが表示されています。

　また、「VlanList」はタグなし（Untagged）以外はVLAN IDの設定が必須のため、設定されているVLAN IDが1つ、または複数表示されます。

　単一の仮想マシンのVLAN設定に絞りたい場合は「-VMName」オプションを使用し、仮想マシン名を指定します（画面2）。

コマンドレット実行例

Get-VMNetworkAdapterVlan -VMName Test-VM07

画面2　「-VMName」オプションで仮想マシンを指定してVLAN情報を取得した

　さらに、仮想ネットワークアダプターも絞り込みたい場合は「-VMNetworkAdapterName」オプションを使用します（画面3）。

コマンドレット実行例

Get-VMNetworkAdapterVlan -VMName Test-VM07 -VMNetworkAdapterName FrontNIC

画面3　「-VMNetworkAdapterName」オプションで仮想ネットワークアダプターを指定してVLAN情報を取得した

目次に戻る

ホストOSが使用する仮想ネットワークアダプターを取得する

　ホストOSが使用する仮想ネットワークアダプター、すなわちホストOSが仮想スイッチ経由で通信する際に使用される仮想ネットワークアダプターを取得する場合は「-ManagementOS」オプションを使用します（画面4）。

コマンドレット実行例

Get-VMNetworkAdapterVlan -ManagementOS

画面4　「-ManagementOS」オプションを使用することで、ホストOSが使用する仮想ネットワークアダプターのVLAN情報のみを取得できる

筆者紹介

後藤 諭史（ごとう さとし）

株式会社ネットワールド所属。Microsoft MVP for Cloud and Datacenter Management（2012-2026）。現業の傍ら、コミュニティーイベントでの登壇や著作にてMicrosoftテクノロジーに関する技術情報の発信、共有を続けている。ネットワークやハードウェアといった物理層に近いところが大好きな、昔ながらのインフラ屋さん。得意技はケーブル整線。近著は『詳解! Windows Server仮想ネットワーク』（日経BP社）。