Add-SCVMHostNetworkAdapter

Add-SCVMHostNetworkAdapter
    -VirtualNetwork <VirtualNetwork>
    [-VLanEnabled]
    [-VLanMode <VlanMode>]
    [-VLanID <UInt16>]
    [-VLanTrunkID <UInt16[]>]
    [-VMHostNetworkAdapter] <HostNetworkAdapter>
    [-JobGroup <Guid>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Add-SCVMHostNetworkAdapter コマンドレットは、Virtual Machine Manager (VMM) によって管理されるホスト上の物理ネットワーク アダプター (ネットワーク インターフェイス カードまたは NIC とも呼ばれます) を仮想ネットワークに追加します。 そのホスト上の各仮想マシンは、仮想ネットワーク アダプターを介してその仮想ネットワークに接続することもできます。

ホスト上に構成された仮想ネットワークは、そのホストにデプロイされた仮想マシン上の複数の仮想ネットワーク アダプターに接続できます。

System Center 2019 以降の VMM には、ホスト上で 1 つ以上の仮想ローカル エリア ネットワーク (VLAN) を構成するための仮想ネットワーク サポートが含まれています。 Add-SCVMHostNetworkAdapter コマンドレットまたは Set-SCVMHostNetworkAdapter コマンドレットを使用して、ホスト上の 1 つの VLAN または複数の VLAN を構成できます。 仮想マシンで対応する VLAN 設定を構成するには、 New-SCVirtualNetworkAdapter コマンドレットまたは Set-SCVirtualNetworkAdapter コマンドレットを使用します。

各種類の VLAN の図については、このコマンドレットの例を参照してください。

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 つだけです。 したがって、アダプターが指定された仮想ネットワークに既に関連付けられている場合、最後のコマンドは失敗します。 仮想ネットワークに新しいアダプターを追加するには、まず既存のホスト アダプターを削除する必要があります。

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 つだけであるため、アダプターが指定した仮想ネットワークに既に関連付けられている場合、最後のコマンドは失敗します。

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 Loopback Adapter をサーバーにインストールすると、ネットワーク アダプターが 1 つしかないホストで実行できます。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

このコマンドレットは、 VMHostNetworkAdapter オブジェクトを返します。