New-SCLogicalSwitchVirtualNetworkAdapter

将虚拟网络适配器 (VNIC) 添加到逻辑交换机。

语法

New-SCLogicalSwitchVirtualNetworkAdapter
   -UplinkPortProfileSet <UplinkPortProfileSet>
   [-EthernetAddressType <EthernetAddressType>]
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-VMNetwork <VMNetwork>]
   [-VMSubnet <VMSubnet>]
   [-PortClassification <PortClassification>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-IPv4AddressPool <StaticIPAddressPool>]
   [-IPv6AddressPool <StaticIPAddressPool>]
   [-InheritsAddressFromPhysicalNetworkAdapter <Boolean>]
   [-IsUsedForHostManagement <Boolean>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [[-Description] <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

说明

New-SCLogicalSwitchVirtualNetworkAdapter cmdlet 将主机的虚拟网络适配器 (VNIC) 作为逻辑交换机定义的一部分添加到上行端口配置文件。

示例

示例 1:创建新的逻辑交换机虚拟网络适配器

PS C:\> $UPPSet = Get-SCUplinkPortProfileSet -Name "R1Uplink"
PS C:\> $VmNetwork = Get-SCVMNetwork -Name "MgmtNet"
PS C:\> New-SCLogicalSwitchVirtualNetworkAdapter -Name "LogSw01_Storage" -UplinkPortProfileSet $uppSetVar -RunAsynchronously -VMNetwork $vmNetwork -VLanEnabled $true -VLanID 2162 -IsUsedForHostManagement $false -IPv4AddressType "Dynamic" -IPv6AddressType "Dynamic"

第一个命令使用 Get-SCUplinkPortProfileSet cmdlet 设置上行端口配置文件,然后将其存储在$UPPSet变量中。

第二个命令使用 Get-SCVMNetwork cmdlet 获取名为 MgmtNet 的虚拟机网络,然后将其存储在$VmNetwork变量中。

最后一个命令创建一个逻辑交换机虚拟网络适配器,该适配器将连同逻辑交换机一起部署到主机。

参数

-Description

指定虚拟网络适配器的说明。

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

-EthernetAddressType

指定以太网地址类型。 此参数的可接受值为:

  • 动态
  • 静态
Type:EthernetAddressType
Accepted values:Dynamic, Static
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InheritsAddressFromPhysicalNetworkAdapter

指示网络适配器是否从物理网络适配器继承其地址。

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

-IPv4AddressPool

指定包含 IPv4 地址的静态地址池。

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

-IPv4AddressType

指定 IPv4 地址类型。 此参数的可接受值为:

  • 动态
  • 静态
Type:EthernetAddressType
Accepted values:Dynamic, Static
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv6AddressPool

指定包含 IPv6 地址的静态地址池。

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

-IPv6AddressType

指定 IPv6 地址类型。 此参数的可接受值为:

  • 动态
  • 静态
Type:EthernetAddressType
Accepted values:Dynamic, Static
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsUsedForHostManagement

指示虚拟网络适配器是否用于主机管理。

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

-Name

指定网络适配器的名称。

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

-PortClassification

指定虚拟网络适配器连接到的交换机的端口分类。

Type:PortClassification
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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

-UplinkPortProfileSet

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

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

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

-VLanEnabled

指示是否为 Hyper-V 或 Citrix XenServer 主机上的虚拟机启用虚拟 LAN (VLAN) 。

  • 单个 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 中的数字标识符分配给虚拟机上的虚拟网络适配器或虚拟机主机上的物理网络适配器。

当 VLan 模式为 Access 时,在 Hyper-V、VMware ESX 或 Citrix XenServer 主机上配置 VLanID。

在绑定到主机上物理网络适配器的虚拟机的虚拟网络适配器上配置 VLanID,或绑定到主机上的内部虚拟网络。

示例格式: -VLanEnabled -VLanMode "Access" -VLANID 35

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

-VMMServer

指定VMM 服务器对象。

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

-VMNetwork

指定 VM 网络对象。

若要获取 VM 网络对象,请使用 Get-SCVMNetwork cmdlet。

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

-VMSubnet

指定虚拟机子网对象。

若要获取 VMSubnet 对象,请使用 Get-SCVMSubnet cmdlet。

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