Set-SCVMHostNetworkAdapter

模块:

VirtualMachineManager

更改 VMM 托管的主机上物理网络适配器的网络相关属性。

语法

Set-SCVMHostNetworkAdapter
   [-VMHostNetworkAdapter] <HostNetworkAdapter>
   [-Description <String>]
   [-VLanMode <VlanMode>]
   [-AvailableForPlacement <Boolean>]
   [-UsedForManagement <Boolean>]
   [-SubnetVLan <SubnetVLan[]>]
   [-RemoveUnassignedVLan <UInt16[]>]
   [-AddOrSetLogicalNetwork <LogicalNetwork>]
   [-RemoveLogicalNetwork <LogicalNetwork>]
   [-EnableNetworkVirtualization <Boolean>]
   [-UplinkPortProfileSet <UplinkPortProfileSet>]
   [-RemoveUplinkPortProfileSet]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCVMHostNetworkAdapter
   [-VMHostNetworkAdapter] <HostNetworkAdapter>
   [-Description <String>]
   [-VLanEnabled <Boolean>]
   [-VLanMode <VlanMode>]
   [-VLanID <UInt16>]
   [-VLanTrunkID <UInt16[]>]
   [-AvailableForPlacement <Boolean>]
   [-UsedForManagement <Boolean>]
   [-RemoveUnassignedVLan <UInt16[]>]
   [-EnableNetworkVirtualization <Boolean>]
   [-UplinkPortProfileSet <UplinkPortProfileSet>]
   [-RemoveUplinkPortProfileSet]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

说明

Set-SCVMHostNetworkAdapter cmdlet 更改由 Virtual Machine Manager (VMM) 托管的主机上的物理网络适配器的网络相关属性。

可以使用此 cmdlet 更改的属性有：

• VLAN 设置：可以使用 VLAN 参数创建或修改单个 VLAN 或多个 VLAN。 有关如何指定 VLAN 设置的插图，请参阅示例。

有关 VLAN 的详细信息以及演示 VLAN 设置的其他示例，请键入 Get-Help Add-SCVMHostNetworkAdapter -Detailed。

示例

示例 1：在主机网络适配器上创建新的虚拟网络，并为虚拟网络指定 VLAN ID

PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost02.Contoso.com"
PS C:\> $HostAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost |  where {$_.Name -like "Intel(R) PRO/1000*" }
PS C:\> New-SCVirtualNetwork -Name "VirtualNetwork01" -VMHost $VMHost -VMHostNetworkAdapter $HostAdapter
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $HostAdapter -VLanEnabled $True -VLanMode "Access" -VLANID 35

第一个命令获取名为 VMHost02 的主机对象，并将对象存储在$VMHost变量中。

第二个命令获取主机网络适配器对象，该对象的名称以 VMHost02 上的“Intel (R) PRO/1000 开头，并将对象存储在$HostAdapter变量中。

第三个命令在 VMHost02 上创建名为 VirtualNetwork01 的虚拟网络，该虚拟网络绑定到存储在$HostAdapter中的主机适配器。

最后一个命令启用 VLAN，将模式设置为 Access (，该模式在单个 VLAN) 内部路由流量，并将网络适配器分配为 35 的 VLANID。

注意：此示例假定主机已连接到 VLAN，否则主机有两个网络适配器。 如果主机具有单个网络适配器，请将适配器分配给 VMM 服务器不可用的 VLAN 将阻止 VMM 管理主机。

示例 2：将 VLan 标记添加到在中继模式下配置的主机网络适配器

PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost03.Contoso.com"
PS C:\> $VMHostNIC = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "Adapter #3"
PS C:\> $NewVlanTags = $VMHostNIC.VlanTags + @(177,355,1012)
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $VMHostNIC -VLANEnabled $TRUE -VLanMode "Trunk" -VLanTrunkID $NewVLanTags

第一个命令获取名为 VMHost03 的主机对象，并将对象存储在$VMHost变量中。

第二个命令通过指定适配器名称并将对象存储在$VMHostNIC变量中来获取主机网络适配器对象。

第三个命令使用主机网络适配器对象的 VlanTags 属性 ($VMHostNIC.VlanTags) 并连接新的标记数组。 更新后的数组会保留 Exisiting VlanTag，并将列出的标记添加到数组。 串联的结果存储在$NewVlanTags中。

最后一个命令将 VLAN 标记的新列表传递给 Set-VMHostNetworkAdapter 的 VLANTrunkID 参数。 每当 VLANTrunkID 参数用于修改 VLAN 中继数字标识符列表时，VLANMode 参数都必须指定值“中继”。

参数

-AddOrSetLogicalNetwork

指定将添加或更新的逻辑网络。

Type:	LogicalNetwork
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AvailableForPlacement

指示 VMM 放置过程是否认为此主机或主机上的此卷符合部署虚拟机的可能位置的条件。 如果此参数设置为$False，可以选择在此主机或卷上部署虚拟机。 默认值为$True。 此参数不适用于 VMware ESX 主机。

当此参数与网络适配器一起使用时，如果设置为$False，则放置不会考虑在此网络适配器上配置的逻辑网络，以确定主机是否适合连接虚拟机。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

指定对象的说明。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableNetworkVirtualization

指定是否启用网络虚拟化。 默认值为$False。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-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

-RemoveLogicalNetwork

指定将删除的逻辑网络。

Type:	LogicalNetwork
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveUnassignedVLan

指定如果指定的 VLAN 与逻辑网络不关联，将从适配器的 VLAN 中继中删除。

Type:	UInt16[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveUplinkPortProfileSet

从主机网络适配器中删除上行端口配置文件集。

Type:	SwitchParameter
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

-SubnetVLan

指定一个或多个 IP 子网和 VLAN 集。

有关创建 SubnetVLan 的信息，请键入 Get-Help New-SCSubNetVLan。

Type:	SubnetVLan[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UplinkPortProfileSet

指定上行端口配置文件集对象。

若要获取上行端口配置文件集对象，请使用 Get-SCUplinkPortProfileSet cmdlet。

Type:	UplinkPortProfileSet
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UsedForManagement

指示对象是否用于管理主机。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
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:	Boolean
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 对象。

相关链接

• Add-SCVMHostNetworkAdapter
• Get-SCVMHost
• Get-SCVMHostNetworkAdapter
• New-SCVirtualNetwork
• Remove-SCVMHostNetworkAdapter