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 コマンドレットを使用して、ホスト上の 1 つの 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 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 オブジェクトを返します。