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
最後一個命令會建立邏輯交換器虛擬網路適配器,此網路適配器會隨著邏輯交換器一起部署至主機。
參數
-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 |