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 つのネットワーク アダプターがあることを確認します。 ホストに単一のネットワーク アダプターがある場合、VMM サーバーで使用できない VLAN にアダプターを割り当てると、VMM でホストを管理できなくなります。 サーバー上に Microsoft Loopback Adapter を最初にインストールする場合は、ホストにネットワーク アダプタが 1 つしかなくても、この例の手順を実行できます。

パラメーター

-JobGroup

同じジョブ グループ識別子を含む最後のコマンドが実行される直前に一括して実行される、一連のコマンドの識別子を指定します。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

このアクションをトリガーしたパフォーマンスとリソースの最適化ヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO ヒントを監査できます。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VirtualNetwork

仮想ネットワーク オブジェクトを指定します。

Type:VirtualNetwork
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VLanEnabled

Hyper-V または Citrix XenServer ホスト上の仮想マシンで使用する仮想 LAN (VLAN) を有効にします。

1 つの VLAN の形式の例: 複数の VLAN の形式の例: -VLANEnabled -VLANMode "Access" -VLANID 35-VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VLanID

1 から 4094 の範囲の数値識別子を、仮想マシン上の仮想ネットワーク アダプターまたは仮想マシン ホスト上の物理ネットワーク アダプターに割り当てます。

Hyper-V、VMware ESX、または Citrix XenServer ホストで VLanID を構成します。

-- VLan モードが Access の場合、外部バインドされた物理ネットワーク アダプターで。

仮想マシンの仮想ネットワーク アダプターで VLanID を構成します。

  • ホスト上の物理ネットワーク アダプターにバインドされているか、または
  • ホスト上の内部仮想ネットワークにバインドされます。

形式の例: -VLanEnabled``-VLanMode "Access" -VLANID 35

Type:UInt16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VLanMode

仮想マシン ホスト上の仮想 LAN (VLAN) が、1 つの VLAN (アクセス モード) または複数の VLAN (トランク モード) 間のトラフィックをサポートするかどうかを指定します。 有効な値は、Access、Trunk です。

Type:VlanMode
Accepted values:Access, Trunk, Invalid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VLanTrunkID

Hyper-V ホスト上の物理ネットワーク アダプタに、1 ~ 4,094 の範囲の数値識別子のリストを割り当てます。

形式の例: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

Type:UInt16[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMHostNetworkAdapter

そのホストにデプロイされた仮想マシンが接続できるホスト上の物理ネットワーク アダプター オブジェクトを指定します。

形式の例: -VMHostNetworkAdapter $VMHostNIC

Type:HostNetworkAdapter
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

出力

VMHostNetworkAdapter

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