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 在 Virtual Machine Manager (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
在运行最后一个包含相同作业组标识符的命令之前，为作为集合运行的一系列命令指定标识符。
| 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
指示作业异步运行，以便控件立即返回到命令 shell。
| 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
启用虚拟 LAN (VLAN) ，供 Hyper-V 或 Citrix XenServer 主机上的虚拟机使用。
单个 VLAN 的示例格式： -VLANEnabled -VLANMode "Access" -VLANID 35 多个 VLAN 的示例格式： -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) 是否支持跨单个 VLAN (访问模式) 的流量，还是跨多个 VLAN (中继模式) 。 有效值为：Access、中继。
| 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-4094 范围内的数字标识符。
示例格式： -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
此 cmdlet 返回 VMHostNetworkAdapter 对象。