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 cmdlet 将虚拟机器管理器（VMM）托管的主机上的物理网络适配器（也称为网络接口卡或 NIC）添加到虚拟网络。 该主机上的每个虚拟机还可以通过虚拟网络适配器连接到该虚拟网络。
主机上配置的虚拟网络可以连接到该主机上部署的虚拟机上的多个虚拟网络适配器。
适用于 System Center 2019 及更高版本的 VMM 包括对主机上配置一个或多个虚拟局域网（VLAN）的虚拟网络支持。 可以使用 Add-SCVMHostNetworkAdapter cmdlet 或 Set-SCVMHostNetworkAdapter cmdlet 在主机上配置单个 VLAN 或多个 VLAN。 若要在虚拟机上配置相应的 VLAN 设置，请使用 New-SCVirtualNetworkAdapter cmdlet 或 Set-SCVirtualNetworkAdapter cmdlet。
有关每种类型的 VLAN 的插图，请参阅此 cmdlet 的示例。
示例
示例 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变量中。
第二个命令获取 VMHost01 上的名为 ExternalVirtualNetwork01 的虚拟网络对象，并将对象存储在$VirtualNetwork变量中。
第三个命令获取 VMHost01 上的名为 HostAdapter01 的物理网络适配器对象，并将该对象存储在$VMHostNetworkAdapter变量中。
最后一个命令将 HostAdapter01 添加到 ExternalVirtualNetwork01。
注意：每个虚拟网络只能添加一个物理主机适配器。 因此，如果适配器已与指定的虚拟网络关联，则最后一个命令将失败。 若要向虚拟网络添加新适配器，必须先删除现有的主机适配器。
示例 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变量中。
第二个命令获取 VMHost02 上的名为 ExternalNetwork02 的虚拟网络对象，并将该对象存储在$VirtualNetwork变量中。
第三个命令获取 VMHost02 上的名为 HostAdapter02 的网络适配器对象，并将适配器对象存储在$VMHostNetworkAdapter变量中。
最后一个命令将 HostAdapter02 添加到虚拟网络 ExternalNetwork02，并使用 802.1Q 标记的 VLAN 1、2、100、200 和 1124 从 ExternalNetwork02 访问外部网络设备。
注意：每个虚拟网络只能添加一个主机适配器，因此，如果适配器已与指定的虚拟网络关联，则最后一个命令将失败。
示例 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变量中。
第二个命令获取 VMHost03 上的名为 ExternalNetwork03 的虚拟网络对象，并将该对象存储在$VirtualNetwork变量中。
第三个命令获取 VMHost03 上的名为 HostAdapter03 的网络适配器对象，并将适配器对象存储在 $VMHostNetworkAdapter 变量中。
最后一个命令将 HostAdapter03 添加到虚拟网络 ExternalNetwork03，并将对 ExternalNetwork03 的访问限制为 VLANID 22。
注意：每个虚拟网络只能添加一个主机适配器，因此，如果适配器已与指定的虚拟网络关联，则最后一个命令将失败。
警告：此示例假定主机已连接到 VLAN，否则请确保主机有两个网络适配器。 如果主机具有单个网络适配器，请将适配器分配给 VMM 服务器不可用的 VLAN 将阻止 VMM 管理主机。 如果首次在服务器上安装Microsoft环回适配器，则可以在只有一个网络适配器的主机上执行此示例中的步骤。
参数
-JobGroup
指定一系列命令的标识符，该命令将在包含相同作业组标识符的最终命令运行之前作为集运行。
| 类型: | Guid |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-JobVariable
指定在此参数命名的变量中跟踪和存储作业进度。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PROTipID
指定触发此操作的性能和资源优化提示（PRO 提示）的 ID。 此参数允许你审核 PRO 提示。
| 类型: | Guid |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RunAsynchronously
指示作业以异步方式运行，以便控件立即返回到命令行界面。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-VirtualNetwork
指定虚拟网络对象。
| 类型: | VirtualNetwork |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-VLanEnabled
启用虚拟 LAN（VLAN），供 Hyper-V 或 Citrix XenServer 主机上的虚拟机使用。
单个 VLAN 的示例格式：-VLANEnabled -VLANMode "Access" -VLANID 35 多个 VLAN 的示例格式：-VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-VLanID
将范围 1-4094 中的数字标识符分配给虚拟机上的虚拟网络适配器或虚拟机主机上的物理网络适配器。
在 Hyper-V、VMware ESX 或 Citrix XenServer 主机上配置 VLanID：
-- 当 VLan 模式为 Access 时，在外部绑定的物理网络适配器上。
在虚拟机的虚拟网络适配器上配置 VLanID：
- 绑定到主机上的物理网络适配器，或
- 绑定到主机上的内部虚拟网络。
示例格式：-VLanEnabled``-VLanMode "Access" -VLANID 35
| 类型: | UInt16 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-VLanMode
指定虚拟机主机上的虚拟 LAN（VLAN）是否支持跨单个 VLAN（访问模式）或跨多个 VLAN（中继模式）的流量。 有效值为：Access、Trunk。
| 类型: | VlanMode |
| 接受的值: | Access, Trunk, Invalid |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-VLanTrunkID
将范围 1-4094 中的数字标识符列表分配给 Hyper-V 主机上的物理网络适配器。
示例格式：-VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
| 类型: | UInt16[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-VMHostNetworkAdapter
指定主机上部署的虚拟机可以连接到的主机上的物理网络适配器对象。
示例格式：-VMHostNetworkAdapter $VMHostNIC
| 类型: | HostNetworkAdapter |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
输出
VMHostNetworkAdapter
此 cmdlet 返回 VMHostNetworkAdapter 对象。