共用方式為


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>]

Description

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 Get-SCVMNetwork 取得名為 MgmtNet 的虛擬機網路,然後將它儲存在$VmNetwork變數中。

最後一個命令會建立邏輯交換器虛擬網路適配器,此網路適配器會隨著邏輯交換器一起部署至主機。

參數

-Description

指定虛擬網路配接器的描述。

類型:String
Position:1
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-EthernetAddressType

指定乙太網路位址類型。 此參數可接受的值為:

  • 動態
  • 靜態的
類型:EthernetAddressType
接受的值:Dynamic, Static
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InheritsAddressFromPhysicalNetworkAdapter

指出網路適配器是否從實體網路適配器繼承其位址。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-IPv4AddressPool

指定包含 IPv4 位址的靜態位址池。

類型:StaticIPAddressPool
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-IPv4AddressType

指定IPv4位址類型。 此參數可接受的值為:

  • 動態
  • 靜態的
類型:EthernetAddressType
接受的值:Dynamic, Static
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-IPv6AddressPool

指定包含 IPv6 位址的靜態位址池。

類型:StaticIPAddressPool
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-IPv6AddressType

指定 IPv6 位址類型。 此參數可接受的值為:

  • 動態
  • 靜態的
類型:EthernetAddressType
接受的值:Dynamic, Static
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-IsUsedForHostManagement

指出虛擬網路適配器是否用於主機管理。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-JobVariable

指定作業進度會追蹤並儲存在此參數所命名的變數中。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Name

指定網路配接器的名稱。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-PortClassification

指定虛擬網路適配器所連線之交換器的埠分類。

類型:PortClassification
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-PROTipID

指定觸發此動作之效能和資源優化提示 (PRO 提示) 的識別碼。 此參數可讓您稽核 PRO 秘訣。

類型:Guid
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RunAsynchronously

表示作業會以異步方式執行,讓控件立即返回命令殼層。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-UplinkPortProfileSet

指定上行通訊埠配置檔集物件。

若要取得上行通訊埠配置檔集物件,請使用 Get-SCUplinkPortProfileSet Cmdlet。

類型:UplinkPortProfileSet
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-VLanEnabled

指出是否要啟用虛擬 LAN(VLAN),以供 Hyper-V 或 Citrix XenServer 主機上的虛擬機使用。

  • 單一 VLAN 的範例格式:-VLANEnabled -VLANMode "Access" -VLANID 35
  • 多個 VLAN 的範例格式:-VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-VLanID

將範圍 1-4094 中的數值識別碼指派給虛擬機上的虛擬網路適配器,或指派給虛擬機主機上的實體網路適配器。

在 VLan 模式為 Access 時,在外部系結實體網路適配器上的 Hyper-V、VMware ESX 或 Citrix XenServer 主機上設定 VLanID。

在系結至主機上實體網路適配器的虛擬機虛擬網路適配器上設定 VLanID,或系結至主機上的內部虛擬網路。

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

類型:UInt16
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-VMMServer

指定 VMM 伺服器物件。

類型:ServerConnection
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-VMNetwork

指定 VM 網路物件。

若要取得 VM 網路物件,請使用 get-SCVMNetwork Cmdlet

類型:VMNetwork
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-VMSubnet

指定虛擬機子網物件。

若要取得 VMSubnet 物件,請使用 Get-SCVMSubnet Cmdlet。

類型:VMSubnet
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False