Set-VMSwitchTeamコマンドレット――Hyper-VのSETが有効化された仮想スイッチのSET関連設定を変更する：Windows PowerShell基本Tips（132）

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

[後藤諭史，＠IT]

印刷

通知 連載「％」の新着をメールで通知

髫穂ｹ晢ｽ�Post

Shareシェア

はてなブックマーク

SharePocket Button

連載目次

　本連載では、Windows PowerShellの基本的なコマンドレットについて、基本的な書式からオプション、具体的な実行例までを分かりやすく紹介していきます。今回は、コンピュータ上で動作するHyper-Vの「スイッチ埋め込みチーミング」（Switch Embedded Teaming：SET）が有効化された仮想スイッチのSET関連の設定を変更する「Set-VMSwitchTeam」コマンドレットです。

目次

Set-VMSwitchTeamの概要 | 書式 | オプション

実行例

• SETの負荷分散アルゴリズムを変更する
• SETを構成するネットワークアダプターを変更する
• SETのチーミングモードを変更するオプションについて

Set-VMSwitchTeamコマンドレットとは？

　仮想スイッチの物理ネットワーク接続の冗長化手法として「スイッチ埋め込みチーミング」が使用可能であることは、本連載第131回の「Get-VMSwitchTeam」コマンドレットで解説した通りです。

　SETが有効化された仮想スイッチは、本連載第127回で紹介した「New-VMSwitch」コマンドレットを「-EnableEmbeddedTeaming」オプション付きで実行することで作成できますが、設定は既定値になります。既定値から設定を変更したい場合には、今回紹介するSet-VMSwitchTeamコマンドレットを使用します。

　本コマンドレットの使用頻度は非常に低いと思われますが、いざ設定を変更する際に迷わないよう使用方法を押さえておきましょう。

【注】Set-VMSwitchTeamは「Windows PowerShell用Hyper-Vモジュール」に含まれるコマンドレットとなります。GUIの「Windowsの機能の有効化」や「役割と機能の追加」からHyper-Vを有効化するか、PowerShellから「Enable-WindowsOptionalFeature」コマンドレットを使用して有効化します。

Set-VMSwitchTeamコマンドレットの書式

Set-VMSwitchTeam [オプション]

Set-VMSwitchTeamコマンドレットの主なオプション

オプション	意味
-Name	設定を変更するSETが有効化された仮想スイッチの名前を指定する
-ComputerName	リモートのHyper-VホストにあるSETが有効化された仮想スイッチの設定を変更する場合にコンピュータ名を指定する。省略可能
-LoadBalancingAlgorithm	負荷分散アルゴリズムを変更する場合に指定する。指定可能な値は「Dynamic」と「HyperVPort」。省略可能
-NetAdapterName	SETを構成する物理ネットワークアダプターを変更する場合、ネットワークアダプター名を指定する。省略可能
-NetAdapterInterfaceDescription	SETを構成する物理ネットワークアダプターを変更する場合、物理ネットワークアダプターのデバイス名を指定する。省略可能

目次に戻る

SETの負荷分散アルゴリズムを変更する

　SETが有効化された仮想スイッチでは、複数の物理ネットワークアダプターを介して複数の物理スイッチと接続できます。

　そのため、仮想マシンの通信を複数のネットワークアダプターでどのように分散するかを決める必要があり、それが「負荷分散アルゴリズム」です。負荷分散アルゴリズムに従って、仮想マシンから送信される通信パケットを矛盾なく物理ネットワークに送出することも、SETが有効化された仮想スイッチの機能の一つです。

　この負荷分散アルゴリズムの既定値は、「Windows Server 2019」以降は「HyperVPort」、「Windows Server 2016」は「Dynamic」となっていますが、明示的に変更したい場合もあるでしょう。

　その場合は、Set-VMSwitchTeamコマンドレットを「-LoadBalancingAlgorithm」オプションを付けて実行します（画面1）。なお、Set-VMSwitchTeamコマンドレットは管理者権限での実行が必要となります。

コマンドレット実行例

Set-VMSwitchTeam -Name "External TeamSwitch" -LoadBalancingAlgorithm Dynamic

画面1　ローカルのHyper-VホストにあるSETが有効化された仮想スイッチの負荷分散アルゴリズムを変更した

　画面1では、Set-VMSwitchTeamコマンドレットの実行前後で、第131回で紹介したGet-VMSwitchTeamコマンドレットを使用して負荷分散アルゴリズムを確認しています。実行前は「HyperVPort」だった負荷分散アルゴリズムが、Set-VMSwitchTeamコマンドレット実行後には「Dynamic」に変更されていることが分かります。

目次に戻る

SETを構成するネットワークアダプターを変更する

　SETが有効化された仮想スイッチに接続されている物理ネットワークアダプターを変更したい場合も、Set-VMSwitchTeamコマンドレットで作業します。

　「-NetAdapterName」オプションを使用する場合には、ネットワークアダプター名を指定して実行します。

　なお、本コマンドレットではネットワークアダプターを指定したものに差し替える（変更する）動きとなり、既存のネットワークアダプターを使用しつつ、新しいネットワークアダプターを追加する動きにはならないので注意が必要です。

　画面2は「-NetAdapterName」オプションを使用して、SETで使用するネットワークアダプターを「イーサネット 2」から「イーサネット 4」と「イーサネット 5」に変更しています。

コマンドレット実行例

Set-VMSwitchTeam -Name "External TeamSwitch" -NetAdapterName "イーサネット 4","イーサネット 5"

画面2　SETで使用するネットワークアダプターを変更した

　使用するネットワークアダプターを変更するという挙動のため、「イーサネット 2」のデバイス「Intel(R) PRO/1000 PT Dual Port Server Adapter」が削除され「イーサネット 4」のデバイス「Intel(R) Ethernet Network Adapter X722-2」と「イーサネット 5」のデバイス「Intel(R) Ethernet Network Adapter X722-2 #2」にネットワークアダプターが差し変わっていることが分かります。

　ネットワークアダプターの変更は、「-NetAdapterInterfaceDescription」オプションでデバイス名を指定することでの変更も可能です（画面3）。しかし、コマンドレットのオプション指定が非常に長くなってしまうので、「-NetAdapterName」オプションの使用が無難でしょう。

コマンドレット実行例

Set-VMSwitchTeam -Name "External TeamSwitch" -NetAdapterInterfaceDescription "Intel(R) Ethernet Network Adapter X722-2","Intel(R) Ethernet Network Adapter X722-2 #2"

画面3　ネットワークアダプターのデバイス名にてSETで使用するネットワークアダプターを変更した

目次に戻る

SETのチーミングモードを変更するオプションについて

　Set-VMSwitchTeamコマンドレットには、SETのチーミングモードを変更できる「-TeamingMode」というオプションも用意されています。

　しかし、本稿執筆時点（2025年3月末）では、チーミングモードは「SwitchIndependent」しかサポートされておらず、このオプションで指定できる値は「SwitchIndependent」のみとなっています。したがって、このオプションは現時点では無視しても構いません。

鬯ｩ謳ｾ�ｽ�ｵ�ｽ�ｽ�ｽ�ｺ鬯ｮ�ｦ�ｽ�ｮ髯ｷ�ｻ�ｽ�ｻ�ｽ�ｽ�ｽ�ｿ�ｽ�ｽ�ｽ�ｽ鬯ｯ�ｯ�ｽ�ｨ�ｽ�ｽ�ｽ�ｾ�ｽ�ｽ�ｽ�ｽ�ｽ�ｽ�ｽ�｣鬯ｯ�ｮ�ｽ�ｴ髣費ｿｽ�ｽ�･�ｽ�ｽ�ｽ�ｳ�ｽ�ｽ�ｽ�ｨ�ｽ�ｽ�ｽ�ｽ髯懶ｽ｣�ｽ�､�ｽ�ｽ�ｽ�ｸ�ｽ�ｽ�ｽ�ｲ鬯ｩ蠅捺��ｽ�ｿ�ｽ�ｽ�ｽ縺､ﾂ€�ｽ�ｽ�ｽ�ｽ�ｽ�ｽ�ｽ�｣鬯ｯ�ｮ�ｽ�ｴ鬯ｩ蟶壽桶�ｽ�ｭ鬮ｮ�｣�ｽ�ｿ�ｽ�ｽ�ｽ�ｽ�ｽ�ｨ鬮ｯ蛹ｺ�ｻ繧托ｽｽ�ｿ�ｽ�ｽ�ｽ�ｽ�ｽ�ｽ�ｽ�ｽ�ｽ�ｺ鬮｣蛹�ｽｽ�ｵ髫ｴ謫ｾ�ｽ�ｴ�ｽ�ｽ隶難ｽ｣�守｢托ｽｭ雜｣�ｽ�｢�ｽ�ｽ�ｽ�ｽ�ｽ�ｽ�ｽ�ｩ鬯ｩ蟷｢�ｽ�｢髫ｴ雜｣�ｽ�｢�ｽ�ｽ�ｽ�ｽ�ｽ�ｽ�ｽ�ｼ鬯ｩ蟷｢�ｽ�｢髫ｴ荳ｻ�ｽ隶捺ｻゑｽｿ�ｽ邵ｺ�､�つ€鬯ｯ�ｮ�ｽ�ｦ�ｽ�ｽ�ｽ�ｪ鬩包ｽｶ闔ｨ�ｽ�ｽ�ｦ�ｽ�ｴ�ｽ縺､ﾂ€髯ｷ闌ｨ�ｽ�ｷ�ｽ�ｽ�ｽ�ｽ�ｽ�ｽ�ｽ�ｻ鬯ｯ�ｯ�ｽ�ｪ�ｽ�ｽ�ｽ�ｭ�ｽ�ｽ�ｽ�ｽ�ｽ�ｽ�ｽ�ｲ鬯ｩ謳ｾ�ｽ�ｵ�ｽ�ｽ�ｽ�ｺ鬮ｯ�ｷ�ｽ�ｷ�ｽ�ｽ�ｽ�ｶ�ｽ�ｽ�ｽ�ｽ�ｽ�ｽ�ｽ�ｽ New

筆者紹介

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

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