Set-SCVirtualNetworkAdapter

模組:

VirtualMachineManager

變更與虛擬機、虛擬機範本或用來在 VMM 中建立虛擬機的硬體配置檔相關聯的虛擬網路適配器屬性。

Syntax

Set-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   [-VMMServer <ServerConnection>]
   -SlotID <Int32>
   [-VirtualNetwork <String>]
   [-RequiredBandwidth <Decimal>]
   [-NoConnection]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-LogicalNetwork <LogicalNetwork>]
   [-NoLogicalNetwork]
   -JobGroup <Guid>
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-NoPortClassification]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RemovePortACL]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Set-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   [-VMMServer <ServerConnection>]
   [-VirtualNetworkAdapter] <VirtualNetworkAdapter>
   [-VirtualNetwork <String>]
   [-RequiredBandwidth <Decimal>]
   [-NoConnection]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-LogicalNetwork <LogicalNetwork>]
   [-NoLogicalNetwork]
   [-JobGroup <Guid>]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-NoPortClassification]
   [-IPv4Addresses <System.Collections.Generic.List`1[System.String]>]
   [-IPv6Addresses <System.Collections.Generic.List`1[System.String]>]
   [-IPv4AddressPools <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]>]
   [-IPv6AddressPools <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RemovePortACL]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Set-SCVirtualNetworkAdapter
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-VMMServer <ServerConnection>]
   [[-VirtualNetworkAdapter] <VirtualNetworkAdapter>]
   -VirtualNetwork <String>
   [-Checkpoint]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

Set-SCVirtualNetworkAdapter Cmdlet 會變更一或多個與虛擬機、虛擬機範本或硬體配置檔相關聯的虛擬網路適配器屬性，以在 Virtual Machine Manager (VMM) 環境中建立虛擬機。

您可以執行的作業包括：

• 將虛擬網路介面卡連線至虛擬網路。

• 中斷虛擬網路適配器與虛擬網路的連線。

• 在虛擬網路配接器上指定網路位置和網路標籤。

• 在虛擬網路配接器上指定 MAC 位址。

• 啟用使用虛擬局域網路 (VLAN) ，並為虛擬網路適配器上的該 VLAN 指定 VLAN 識別碼 (數值識別碼) 。

注意

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

範例

範例 1：將虛擬網路適配器連線至虛擬網路

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.PhysicalAddress -eq "00:16:D3:CC:00:1B" }
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter -VirtualNetwork "ExternalVirtualNetwork01"

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

第二個命令會取得 VM01 上的所有虛擬網路適配器對象、選取實體 (MAC) 位址為 00：16：D3：CC：00：1B 的適配卡物件，然後將對象儲存在$Adapter變數中。

最後一個命令會將儲存在 $Adapter 中的虛擬網路適配器連線到包含 VM01 的主機上名為 ExternalVirtualNetwork01 的虛擬網路。

範例 2：指定虛擬網路適配器的靜態 MAC 位址

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.ID -eq "5c0ee80a-731f-41c8-92f0-85a1619f9a1b" }
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter -PhysicalAddressType "Static" -PhysicalAddress "00:16:D3:CC:00:1C"

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

第二個命令會取得 VM02 上的所有虛擬網路適配器對象、選取具有指定標識碼的虛擬網路適配器，然後將物件儲存在$Adapter變數中。 此範例假設此適配卡目前有動態 MAC 位址。

最後一個命令會指定儲存在 $Adapter 中的虛擬網路適配器使用靜態 MAC 位址 00：16：D3：CC：00：1C。

範例 3：指定靜態 MAC 位址，並將它指派給現有的虛擬網路適配器

PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter (Get-VirtualNetworkAdapter -VM $VM | where { $_.ID -eq "95e9cfda-861c-44a3-b2ba-2f796dfe691c"}) -MACAddressType "Static" -MACAddress "00-00-00-00-00-00"

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

第二個命令會依標識符取得 VM03 上的虛擬網路適配器物件、指定適配卡使用靜態 MAC 位址類型，並將 MAC 位址指派給它。

範例 4：中斷指定的虛擬網路適配器與虛擬網路的連線

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapters[1] -NoConnection

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

第二個命令會取得 VM04 上的所有虛擬網路適配器物件，並將配接器物件儲存在$Adapters中。 此範例假設 VM04 至少有兩個虛擬網路適配器。

最後一個命令會使用 NoConnection 參數，將第二張虛擬網路適配器 (配接器[1]中斷連線，) 與其連線的任何虛擬網路中斷聯機。

範例 5：指定現有虛擬機的 VMware 連接埠群組

PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $Adapter = $VM.VirtualNetworkAdapters[0]
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter -VMwarePortGroup "VM Network"

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

第二個命令會將 VM05 上的第一個 [0] 虛擬網路適配器儲存在 $Adapter 變數中。

最後一個命令會將儲存在 $Adapter適配卡的適配卡虛擬網路適配器設定為 VM 網路，這是您想要此適配卡連線的 VMware 埠群組名稱。

參數

-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

-Checkpoint

指示使用 Can Checkpoint 許可權。

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

-IPv4Addresses

指定 IPv4 位址的清單。

Type:	System.Collections.Generic.List`1[System.String]
Aliases:	IPv4Address
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IPv4AddressPools

指定IPv4位址池的清單。

Type:	System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]
Aliases:	IPv4AddressPool
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

-IPv6Addresses

指定 IPv6 位址的清單。

Type:	System.Collections.Generic.List`1[System.String]
Aliases:	IPv6Address
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IPv6AddressPools

指定 IPv6 位址池的清單。

Type:	System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]
Aliases:	IPv6AddressPool
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

-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 位址類型。 有效值為：Static、Dynamic。

Type:	String
Aliases:	EthernetAddressType, PhysicalAddressType
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

-NoLogicalNetwork

表示沒有任何邏輯網路與此虛擬網路適配器相關聯。

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

-NoPortClassification

表示未提供埠分類。

Type:	SwitchParameter
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:	False
Accept wildcard characters:	False

-PROTipID

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

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

-RemovePortACL

表示此作業會移除 ACL) (埠存取控制清單。

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

-RequiredBandwidth

指定網路配接器所需的網路頻寬。

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

-SlotID

指定用來識別裝置的數值識別碼。

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

-VirtualNetwork

指定虛擬網路物件。

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

-VirtualNetworkAdapter

指定虛擬機器的虛擬網路介面卡物件。

主機類型支援下列虛擬網路適配器數目：

• Hyper-V。 每個虛擬機最多四個模擬適配卡。 Windows Server 2003 x64 客體作業系統上的模擬網路適配器沒有可用的驅動程式。

• Hyper-V。 每個虛擬機最多八個綜合適配卡。

• VMware ESX。 每個虛擬機最多四個模擬適配卡。

• Citrix XenServer。 每個虛擬機最多有七個模擬適配卡。

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

-VLanEnabled

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

• 範例： -VLANEnabled -VLANID 35

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

-VLanID

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

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

範例格式： -VLanEnabled -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:	False
Accept wildcard characters:	False

-VMNetworkServiceSetting

指定 VM 網路服務設定。

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

-VMwarePortGroup

指定 VMware 連接埠群組。

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

輸出

VirtualNetworkAdapter

此 Cmdlet 會傳回 VirtualNetworkAdapter 物件。

備註

• 需要可使用 Get-SCVirtualNetworkAdapter Cmdlet 擷取的 VMM 虛擬網路適配器物件。

相關連結

• Get-SCVirtualMachine
• Get-SCVirtualNetworkAdapter
• New-SCVirtualNetworkAdapter
• Remove-SCVirtualNetworkAdapter
• Repair-SCVirtualNetworkAdapter