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 对象。