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

指示作业以异步方式运行,以便控件立即返回到命令行界面。

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 (Trunk 模式) 的流量。 有效值为: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-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 对象。