New-SCVirtualNetworkAdapter

模組:

VirtualMachineManager

在 VMM 中使用的虛擬機、虛擬機範本或硬體配置檔上建立虛擬網路適配器。

Syntax

New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   -VM <VM>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   [-VMHost <Host>]
   [-LogicalSwitch <LogicalSwitch>]
   -JobGroup <Guid>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   -VMTemplate <Template>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   -HardwareProfile <HardwareProfile>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-IPv4AddressPool <StaticIPAddressPool>]
   [-IPv6AddressPool <StaticIPAddressPool>]
   [-InheritsAddressFromPhysicalNetworkAdapter <Boolean>]
   -VMHost <Host>
   -LogicalSwitch <LogicalSwitch>
   [-JobGroup <Guid>]
   [-Name <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-IPv4Address <String>]
   [-IPv6Address <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

New-SCVirtualNetworkAdapter Cmdlet 會在用來建立 Virtual Machine Manager 所管理的虛擬機、虛擬機範本或硬體配置檔上建立虛擬網路適配器， (VMM) 。

網路位置

您可以使用 New-SCVirtualNetworkAdapter Cmdlet 來指定網路位置，並在建立配接器時將虛擬網路適配器連線到主機上設定的虛擬網路，或者稍後可以使用 Set-SCVirtualNetworkAdapter Cmdlet 來設定這些和其他設定。

靜態或動態 MAC 位址

您可以指定虛擬網路適配器是否使用靜態或動態 MAC 位址，也可以指定靜態 MAC 位址。

模擬或綜合 虛擬網路 配接器

您可以使用 New-SCVirtualNetworkAdapter Cmdlet 來建立適配卡，其類型為模擬 (預設) 或綜合。

對於任何類型的主機上的虛擬機 (Hyper-V、VMware 或 XenServer) ，您可以在模擬特定實體網路適配器的虛擬機上設定虛擬網路適配器。

對於 Hyper-V 主機上的虛擬機，如果安裝在虛擬機上的客體操作系統是虛擬化感知作業系統， (例如 Windows Server 2008 或 Windows Server 2016，而某些版本的 Linux) ，VMM 可讓您在虛擬機上設定高效能綜合虛擬網路適配器，以與主機上的實體硬體通訊。 您必須使用 Synthetic 參數明確指定虛擬網路適配器是綜合的。

虛擬局域網路

VMM 支援在主機上設定一或多個虛擬網路 (VLAN) ，以供部署在該主機上的虛擬機使用。 您可以使用 New-SCVirtualNetworkAdapter Cmdlet (或 Set-SCVirtualNetworkAdapter Cmdlet 搭配 VLAN 參數) ，將虛擬機上的虛擬網路適配器連結至 VLAN。 若要在主機網路適配器上設定對應的 VLAN 設定，請使用 Add-SCVMHostNetworkAdapter Cmdlet 或 Set-SCVMHostNetworkAdapter Cmdlet。

如需如何設定 VLAN 的圖例，請參閱此 Cmdlet 的範例，並查看 New-SCVMHostNetworkAdapterConfig 和 Set-SCVMHostNetworkAdapter 的範例。

注意

• VMM 2019 UR2 和更新版本中包含新的參數 [-PhysicalNetworkAdapterName ]。 如需詳細資訊，請參閱參數。
• VMM 2019 UR3 和更新版本中包含新的參數 [-AllowedVLanList] 和 [-NativeVLanId ]。 如需詳細資訊，請參閱參數。

範例

範例 1：在虛擬機上建立虛擬網路適配器

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCVirtualNetworkAdapter -VM $VM

第一個命令會取得名為 VM01 的虛擬機物件，並將物件儲存在 $VM 變數中。

第二個命令會在 VM01 上建立虛擬網路介面卡。

範例 2：在虛擬機範本上建立虛擬網路適配器

PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> New-SCVirtualNetworkAdapter -VMTemplate $VMTemplate

第一個命令會取得名為 VMTemplate01 的虛擬機範本物件，並將物件儲存在$VMTemplate變數中。

第二個命令會在 VMTemplate01 上建立虛擬網路適配器。

範例 3：在硬體配置檔上建立仿真的虛擬網路適配器和綜合虛擬網路適配器

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> New-SCVirtualNetworkAdapter -HardwareProfile $HWProfile
PS C:\> New-SCVirtualNetworkAdapter -HardwareProfile $HWProfile -Synthetic

第一個命令會從 VMM 連結庫取得名為 NewHWProfile01 的硬體配置檔物件，並將物件儲存在$HWProfile變數中。

第二個命令會在 NewHWProfile01 上建立虛擬網路適配器 (「原生」或仿真的適配卡) 。

最後一個命令會在 NewHWProfile01 上建立綜合虛擬網路配接器。

範例 4：在虛擬機上建立虛擬網路適配器，並指派唯一的 MAC 位址

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $VNIC = New-SCVirtualNetworkAdapter -VM $VM
PS C:\> $MACPool = Get-SCMACAddressPool -Name "MAC Address Pool 01"
PS C:\> Grant-SCMACAddress -MACAddressPool $MACPool -VirtualNetworkAdapter $VNIC

第一個命令會取得名為 VM04 的虛擬機物件，並將物件儲存在$VM變數中。

第二個命令會在儲存$VM (VM04) 的虛擬機上建立虛擬網路適配器，並將物件儲存在$VNIC變數中。

第三個命令會取得名為 MAC 位址池 01 的 MAC 位址池物件，並將物件儲存在$MACPool 變數中。

最後一個命令會從儲存在 $MACPool 中的位址池取得下一個可用的 MAC 位址，並將它指派給儲存在 $VNIC 中的虛擬網路適配器。

範例 5：建立具有靜態 MAC 位址和特定 VLAN 識別碼的虛擬網路適配器

PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $LogicalNet = Get-SCLogicalNetwork -Name "LogicalNetwork01"
PS C:\> $VirtualNet = Get-SCVirtualNetwork -Name "ExternalVirtualNetwork01"
PS C:\> New-SCVirtualNetworkAdapter -VM $VM -LogicalNetwork $LogicalNet -VirtualNetwork $VirtualNet -MACAddress "00-16-D3-CC-00-1A" -MACAddressType "Static" -VLANEnabled $True -VLANId 3

第一個命令會取得名為 VM05 的虛擬機物件，並將物件儲存在 $VM 變數中。

第二個命令會取得名為 LogicalNetwork01 的邏輯網路物件，並將物件儲存在$LogicalNet變數中。

第三個命令會取得名為 ExternalVirtualNetwork01 的虛擬網路物件，並將物件儲存在$VirtualNet變數中。

最後一個命令會為 VM05 建立新的虛擬網路適配器、將適配卡連線到儲存在 $LogicalNet 中的邏輯網路，以及儲存在 $VirtualNet 中的虛擬網路。 此命令會提供虛擬網路適配器的靜態 MAC 位址、啟用 VLAN，並指定 VLAN 識別碼為 3。

注意：此範例假設您的主機已連線到 VLAN，否則您的主機有兩個網路適配器。 如果您的主機有單一網路適配器，請將適配卡指派給 VMM 伺服器無法使用的 VLAN，將會防止 VMM 管理主機。

參數

-AdapterFlags

{{Fill AdapterFlags Description}}

Type:	VirtualNetworkAdapterFlags
Accepted values:	None, ApplyInfrastructurePortProfileForNetworkController, ApplyNCPortProfileForNetworkController, ApplyInstaceIDPortProfileForNetworkController
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowedVLanList

指定虛擬機器網路介面卡允許的虛擬 LAN 清單。

注意

此參數適用於 VMM 2019 UR3 和更新版本。

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

-DevicePropertiesAdapterName

指定網路配接器的名稱。

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

-DevicePropertiesAdapterNameMode

指定配接器名稱模式。

Type:	DevicePropertiesAdapterNameMode
Accepted values:	Disabled, VMNetwork, Custom
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableGuestIPNetworkVirtualizationUpdates

指出客體是否啟用IP網路虛擬化更新。

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

-EnableMACAddressSpoofing

啟用 ，當設定為 $True 時，MAC 位址詐騙。

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

-EnableVMNetworkOptimization

啟用 ，當設定為 $True 時，虛擬機網路優化。

這項功能可改善虛擬機的網路效能，其中包含支援虛擬機佇列 (VMQ) 或 TCP Chimney 卸除的網路適配器。 VMQ 可讓您為每個虛擬網路適配器建立唯一的網路佇列。 TCP Chimney 卸除可讓網路流量處理從網路堆疊卸除。

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

-HardwareProfile

指定硬體設定檔物件。

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

-InheritsAddressFromPhysicalNetworkAdapter

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

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

-IPv4Address

指定 IPv4 位址。

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

-IPv6Address

指定 IPv6 位址。

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

-JobGroup

指定一系列命令的識別碼，這些命令會在執行包含相同工作群組識別碼的最終命令之前，使用整組的方式來執行。

Type:	Guid
Position:	Named
Default value:	None
Required:	True
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

-LogicalNetwork

指定邏輯網路。 邏輯網路是IP子網和VLAN的具名群組，可用來組織和簡化網路指派。

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

-LogicalSwitch

指定邏輯交換器物件。

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

-MACAddress

指定電腦上的實體或虛擬網路適配器的 MAC 位址或一組 MAC 位址。

• 單一 MAC 位址的範例格式： -MACAddress "00-15-5D-B4-DC-00"
• 一組 MAC 位址的範例格式： -MACAddress "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"

Type:	String
Aliases:	EthernetAddress, PhysicalAddress
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MACAddressType

指定要用於虛擬網路配接器的 MAC 位址類型。 有效值為：靜態、動態。

Type:	String
Aliases:	EthernetAddressType, PhysicalAddressType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

指定網路物件的名稱。

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

-NativeVLanId

指定虛擬機器網路介面卡的原生虛擬 LAN 識別碼。

注意

此參數適用於 VMM 2019 UR3 和更新版本。

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

-NetworkLocation

指定實體網路介面卡或虛擬網路介面卡的網路位置，或變更主機之實體網路介面卡的預設網路位置。

範例格式： -NetworkLocation $NetLoc ($NetLoc 可能包含 Corp.Contoso.com) -OverrideNetworkLocation $True -NetworkLocation "HostNICNewLocation.Contoso.com"

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

-NetworkTag

指定與虛擬網路介面卡關聯的一個字或詞組，而這個虛擬網路介面卡是設定為連線到主機上的特定內部或外部網路。

NetworkTag 參數會識別與相同網路成員相同的 NetworkTag 的所有虛擬機。 VMM 會在評估要部署虛擬機的可能候選主機時，使用 NeworkTag) (。 如果主機未在網路上包含與要放置之虛擬機相同的 NetworkTag ，主機會在放置程式中收到零顆星。

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

-NoConnection

中斷虛擬網路介面卡與虛擬網路的連線。

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

-NoVMNetwork

表示未指定虛擬機網路。

Type:	SwitchParameter
Aliases:	NoLogicalNetwork
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OnBehalfOfUser

指定使用者名稱。 此 Cmdlet 代表此參數指定的用戶運作。

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

-OnBehalfOfUserRole

指定使用者角色。 若要取得使用者角色，請使用 Get-SCUserRole Cmdlet。 此 Cmdlet 代表此參數所指定的使用者角色運作。

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

-PhysicalNetworkAdapterName

指定實體網路配接器的名稱。

注意

此參數適用於 VMM 2019 UR2 和更新版本。

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

-PortACL

指定埠 ACL 物件。

Type:	PortACL
Position:	Named
Default value:	None
Required:	False
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 提示 (PRO 提示的標識碼) 。 此參數可讓您稽核 PRO 秘訣。

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

-RunAsynchronously

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

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

-Synthetic

指定部署在 Hyper-V 主機上的虛擬機上的裝置，例如虛擬網路適配器是高效能綜合裝置。 虛擬機器需要感知虛擬化來賓作業系統。

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

-VirtualNetwork

指定虛擬網路物件。

Type:	String
Position:	0
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 中的數值識別碼指派給虛擬機上的虛擬網路適配器，或指派給虛擬機主機上的實體網路適配器。

在 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

-VM

指定虛擬機器物件。

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

-VMHost

指定虛擬機器主機物件。 VMM 支援 Hyper-V 主機、VMware ESX 主機和 Citrix XenServer 主機。

如需每種主機類型的詳細資訊，請參閱 Add-SCVMHost Cmdlet。

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

-VMMServer

指定 VMM 伺服器物件。

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

-VMNetwork

指定虛擬機網路物件。

若要取得虛擬機網路物件，請使用 Get-SCVMNetwork Cmdlet。

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

-VMNetworkServiceSetting

指定虛擬機網路服務設定。

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

-VMSubnet

指定虛擬機子網物件。

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

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

-VMTemplate

指定用來建立虛擬機器的 VMM 範本物件。

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

-VMwarePortGroup

指定 VMware 連接埠群組。

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

輸出

VirtualNetworkAdapter

此 Cmdlet 會傳回 VirtualNetworkAdapter 物件。

備註

• 需要 VMM 虛擬機物件、虛擬機範本物件或硬體配置檔物件，這可以使用 Get-SCVirtualMachine、 Get-SCVMTemplate 和 Get-SCHardwareProfile Cmdlet 分別擷取。

相關連結

• Get-SCHardwareProfile
• Get-SCLogicalNetwork
• Get-SCMACAddressPool
• Get-SCVirtualMachine
• Get-SCVirtualNetwork
• Get-SCVirtualNetworkAdapter
• Get-SCVMTemplate
• Grant-SCMACAddress
• Remove-SCVirtualNetworkAdapter
• Repair-SCVirtualNetworkAdapter
• Set-SCVirtualNetworkAdapter