Set-SCVMHostNetworkAdapter
更改 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 对象。