Add-SCVMHostNetworkAdapter
VMM によって管理されるホスト上の物理ネットワーク アダプターを仮想ネットワークに追加します。
構文
Add-SCVMHostNetworkAdapter
-VirtualNetwork <VirtualNetwork>
[-VLanEnabled]
[-VLanMode <VlanMode>]
[-VLanID <UInt16>]
[-VLanTrunkID <UInt16[]>]
[-VMHostNetworkAdapter] <HostNetworkAdapter>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
説明
Add-SCVMHostNetworkAdapter コマンドレットは、仮想マシン マネージャー (VMM) によって管理されるホスト上の物理ネットワーク アダプター (ネットワーク インターフェイス カードまたは NIC とも呼ばれます) を仮想ネットワークに追加します。 そのホスト上の各仮想マシンは、仮想ネットワーク アダプターを介してその仮想ネットワークに接続することもできます。
ホスト上に構成された仮想ネットワークは、そのホストにデプロイされている仮想マシン上の複数の仮想ネットワーク アダプターに接続できます。
System Center 2019 以降の VMM には、ホスト上に 1 つ以上の仮想ローカル エリア ネットワーク (VLAN) を構成するための仮想ネットワークのサポートが含まれています。 Add-SCVMHostNetworkAdapter コマンドレットまたは Set-SCVMHostNetworkAdapter コマンドレットを使用して、ホスト上の単一の VLAN または複数の VLAN を構成できます。 仮想マシンで対応する VLAN 設定を構成するには、New-SCVirtualNetworkAdapter コマンドレットまたは Set-SCVirtualNetworkAdapter コマンドレットを使用します。
各種類の VLAN の図については、このコマンドレットの例を参照してください。
例
例 1: 仮想ネットワークに物理ホスト ネットワーク アダプターを追加する
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork01"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter01"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter
最初のコマンドは、VMHost01 という名前のホスト オブジェクトを取得し、$VMHost変数にオブジェクトを格納します。
2 番目のコマンドは、VMHost01 上の ExternalVirtualNetwork01 という名前の仮想ネットワーク オブジェクトを取得し、そのオブジェクトを $VirtualNetwork 変数に格納します。
3 番目のコマンドは、VMHost01 上の HostAdapter01 という名前の物理ネットワーク アダプター オブジェクトを取得し、そのオブジェクトを $VMHostNetworkAdapter 変数に格納します。
最後のコマンドは、HostAdapter01 を ExternalVirtualNetwork01 に追加します。
注: 仮想ネットワークごとに追加できる物理ホスト アダプターは 1 つだけです。 そのため、アダプターが指定された仮想ネットワークに既に関連付けられている場合、最後のコマンドは失敗します。 仮想ネットワークに新しいアダプターを追加するには、まず既存のホスト アダプターを削除する必要があります。
例 2: "トランク" モードを使用する VLAN に物理ホスト ネットワーク アダプターを追加する
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalNetwork02"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter02"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
最初のコマンドは、VMHost02 という名前のホスト オブジェクトを取得し、そのオブジェクトを $VMHost 変数に格納します。
2 番目のコマンドは、VMHost02 上の ExternalNetwork02 という名前の仮想ネットワーク オブジェクトを取得し、$VirtualNetwork変数にオブジェクトを格納します。
3 番目のコマンドは、VMHost02 上の HostAdapter02 という名前のネットワーク アダプター オブジェクトを取得し、$VMHostNetworkAdapter変数にアダプター オブジェクトを格納します。
最後のコマンドは、HostAdapter02 を仮想ネットワーク ExternalNetwork02 に追加し、802.1Q タグ付き VLAN 1、2、100、200、1124 を使用して ExternalNetwork02 から外部ネットワーク デバイスへのアクセスを有効にします。
注: 仮想ネットワークごとに追加できるホスト アダプターは 1 つだけであるため、アダプターが指定された仮想ネットワークに既に関連付けられている場合、最後のコマンドは失敗します。
例 3: "アクセス" モードを使用する VLAN に物理ホスト ネットワーク アダプターを追加する
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork03"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter03"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLanEnabled -VLanMode "Access" -VLanID 22
最初のコマンドは、VMHost03 という名前のホスト オブジェクトを取得し、そのオブジェクトを $VMHost 変数に格納します。
2 番目のコマンドは、VMHost03 上の ExternalNetwork03 という名前の仮想ネットワーク オブジェクトを取得し、$VirtualNetwork変数にオブジェクトを格納します。
3 番目のコマンドは、VMHost03 上の HostAdapter03 という名前のネットワーク アダプター オブジェクトを取得し、$VMHostNetworkAdapter 変数にアダプター オブジェクトを格納します。
最後のコマンドは、HostAdapter03 を仮想ネットワーク ExternalNetwork03 に追加し、ExternalNetwork03 へのアクセスを VLANID 22 に制限します。
注: 仮想ネットワークごとに追加できるホスト アダプターは 1 つだけであるため、アダプターが指定された仮想ネットワークに既に関連付けられている場合、最後のコマンドは失敗します。
注意: この例では、ホストが既に VLAN に接続されていることを前提としています。そうでない場合は、ホストに 2 つのネットワーク アダプターがあることを確認します。 ホストに 1 つのネットワーク アダプターがある場合、VMM サーバーで使用できない VLAN にアダプターを割り当てると、VMM がホストを管理できなくなります。 最初に Microsoft ループバック アダプターをサーバーにインストールする場合は、ネットワーク アダプターが 1 つしかないホストで、この例の手順を実行できます。
パラメーター
-JobGroup
同じジョブ グループ識別子を含む最後のコマンドが実行される直前にセットとして実行される一連のコマンドの識別子を指定します。
型: | Guid |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
型: | Guid |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VirtualNetwork
仮想ネットワーク オブジェクトを指定します。
型: | VirtualNetwork |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-VLanEnabled
Hyper-V または Citrix XenServer ホスト上の仮想マシンで使用する仮想 LAN (VLAN) を有効にします。
1 つの VLAN の形式の例: -VLANEnabled -VLANMode "Access" -VLANID 35
複数の VLAN の形式の例: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VLanID
1 から 4094 の範囲の数値識別子を、仮想マシン上の仮想ネットワーク アダプターまたは仮想マシン ホスト上の物理ネットワーク アダプターに割り当てます。
Hyper-V、VMware ESX、または Citrix XenServer ホストで VLanID を構成します。
-- VLan モードが Access の場合、外部にバインドされた物理ネットワーク アダプター上。
仮想マシンの仮想ネットワーク アダプターに VLanID を構成します。
- ホスト上の物理ネットワーク アダプターにバインドされているか、または
- ホスト上の内部仮想ネットワークにバインドされます。
形式の例: -VLanEnabled``-VLanMode "Access" -VLANID 35
型: | UInt16 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VLanMode
仮想マシン ホスト上の仮想 LAN (VLAN) が、1 つの VLAN (アクセス モード) または複数の VLAN (トランク モード) を介したトラフィックをサポートするかどうかを指定します。 有効な値は Access、Trunk です。
型: | VlanMode |
指定可能な値: | Access, Trunk, Invalid |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VLanTrunkID
1 から 4094 の範囲の数値識別子の一覧を、Hyper-V ホスト上の物理ネットワーク アダプターに割り当てます。
形式の例: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
型: | UInt16[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VMHostNetworkAdapter
そのホストにデプロイされた仮想マシンが接続できるホスト上の物理ネットワーク アダプター オブジェクトを指定します。
形式の例: -VMHostNetworkAdapter $VMHostNIC
型: | HostNetworkAdapter |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
出力
VMHostNetworkAdapter
このコマンドレットは、VMHostNetworkAdapter オブジェクトを返します。