Set-SCVMHostNetworkAdapter
變更 VMM 所管理主機上實體網路介面卡的網路相關屬性。
Syntax
Set-SCVMHostNetworkAdapter
[-VMHostNetworkAdapter] <HostNetworkAdapter>
[-Description <String>]
[-VLanMode <VlanMode>]
[-AvailableForPlacement <Boolean>]
[-UsedForManagement <Boolean>]
[-SubnetVLan <SubnetVLan[]>]
[-RemoveUnassignedVLan <UInt16[]>]
[-AddOrSetLogicalNetwork <LogicalNetwork>]
[-RemoveLogicalNetwork <LogicalNetwork>]
[-EnableNetworkVirtualization <Boolean>]
[-UplinkPortProfileSet <UplinkPortProfileSet>]
[-RemoveUplinkPortProfileSet]
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Set-SCVMHostNetworkAdapter
[-VMHostNetworkAdapter] <HostNetworkAdapter>
[-Description <String>]
[-VLanEnabled <Boolean>]
[-VLanMode <VlanMode>]
[-VLanID <UInt16>]
[-VLanTrunkID <UInt16[]>]
[-AvailableForPlacement <Boolean>]
[-UsedForManagement <Boolean>]
[-RemoveUnassignedVLan <UInt16[]>]
[-EnableNetworkVirtualization <Boolean>]
[-UplinkPortProfileSet <UplinkPortProfileSet>]
[-RemoveUplinkPortProfileSet]
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Description
Set-SCVMHostNetworkAdapter Cmdlet 會變更 Virtual Machine Manager 所管理主機上實體網路介面卡的網路相關屬性， (VMM) 。
您可以使用這個指令程式變更的內容包括：
- VLAN 設定：您可以使用 VLAN 參數來建立或修改單一 VLAN 或多個 VLAN。 如需如何指定 VLAN 設定的圖例，請參閱範例。
如需 VLAN 的詳細資訊，以及說明 VLAN 設定的其他範例，請輸入 Get-Help Add-SCVMHostNetworkAdapter -Detailed 。
範例
範例 1：在主機網路介面卡上建立新的虛擬網路，並指定虛擬網路的 VLAN 識別碼
PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost02.Contoso.com"
PS C:\> $HostAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost | where {$_.Name -like "Intel(R) PRO/1000*" }
PS C:\> New-SCVirtualNetwork -Name "VirtualNetwork01" -VMHost $VMHost -VMHostNetworkAdapter $HostAdapter
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $HostAdapter -VLanEnabled $True -VLanMode "Access" -VLANID 35第一個命令會取得名為 VMHost02 的主機物件，並將物件儲存在$VMHost變數中。
第二個命令會取得名稱開頭為 「Intel (R) PRO/1000 on VMHost02 的主機網路介面卡物件，並將物件儲存在 $HostAdapter 變數中。
第三個命令會在 VMHost02 上建立名為 VirtualNetwork01 的虛擬網路，該虛擬網路會系結至儲存在 $HostAdapter 中的主機介面卡。
最後一個命令會啟用 VLAN、將模式設定為 Access (，以在單一 VLAN) 內部路由傳送流量，並將網路介面卡指派 VLANID 為 35。
注意：此範例假設您的主機已連線到 VLAN，否則您的主機有兩張網路介面卡。 如果您的主機有單一網路介面卡，請將介面卡指派給 VMM 伺服器無法使用的 VLAN，將會防止 VMM 管理主機。
範例 2：將 VLan 標籤新增至主幹模式中設定的主機網路介面卡
PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost03.Contoso.com"
PS C:\> $VMHostNIC = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "Adapter #3"
PS C:\> $NewVlanTags = $VMHostNIC.VlanTags + @(177,355,1012)
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $VMHostNIC -VLANEnabled $TRUE -VLanMode "Trunk" -VLanTrunkID $NewVLanTags第一個命令會取得名為 VMHost03 的主機物件，並將物件儲存在$VMHost變數中。
第二個命令會藉由指定介面卡名稱來取得主機網路介面卡物件，並將物件儲存在$VMHostNIC變數中。
第三個命令會使用主機網路介面卡物件的 VlanTags 屬性 ($VMHostNIC.VlanTags) ，並串連新的標記陣列。 更新的陣列會保留 Exisiting VlanTags，並將列出的標記新增至陣列。 串連的結果會儲存在$NewVlanTags中。
最後一個命令會將新的 VLAN 標籤清單傳遞給Set-VMHostNetworkAdapter的VLANTrunkID參數。 每當使用VLANTrunkID參數來修改 VLAN 主幹數值識別碼清單時，VLANMode參數必須指定值 「Trunk」。
參數
-AddOrSetLogicalNetwork
指定將新增或更新的邏輯網路。
| Type: | LogicalNetwork |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AvailableForPlacement
指出 VMM 放置程式會將此主機或主機上的此磁片區視為部署虛擬機器的可能位置。 如果此參數設定為 $False，您可以選擇在此主機或磁片區上部署虛擬機器。 預設值為 $True。 此參數不適用於 VMware ESX 主機。
當此參數與網路介面卡搭配使用時，如果設定為 $False，則放置不會考慮此網路介面卡上設定的邏輯網路，以判斷主機是否適合連線虛擬機器。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
指出指定之物件的描述。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableNetworkVirtualization
指定是否啟用網路虛擬化。 預設值為 $False。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
指定一系列命令的識別碼，這些命令會在執行包含相同工作群組識別碼的最終命令之前，使用整組的方式來執行。
| Type: | Guid |
| 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 |
-PROTipID
指定觸發此動作 (PRO 提示) 效能和資源優化提示的識別碼。 此參數可讓您稽核 PRO 秘訣。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveLogicalNetwork
指定將移除的邏輯網路。
| Type: | LogicalNetwork |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveUnassignedVLan
指定如果指定的 VLAN 與邏輯網路沒有關聯，將會從介面卡的 VLAN 主幹中移除。
| Type: | UInt16[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveUplinkPortProfileSet
從主機網路介面卡移除上行通訊埠設定檔集。
| Type: | SwitchParameter |
| 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 |
-SubnetVLan
指定一或多個 IP 子網和 VLAN 集合。
如需建立 SubnetVLan 的相關資訊，請輸入 Get-Help New-SCSubNetVLan 。
| Type: | SubnetVLan[] |
| 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: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UsedForManagement
指出物件是否用來管理主機。
| Type: | Boolean |
| Position: | Named |
| 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 範圍內的數值識別碼指派給虛擬機器上的虛擬網路介面卡，或指派給虛擬機器主機上的實體網路介面卡。
在 Hyper-V、VMware ESX 或 Citrix XenServer 主機上設定 VLanID：
- 當 VLan 模式為 Access 時，在外部系結的實體網路介面卡上。
在虛擬機器的虛擬網路介面卡上設定 VLanID：
- 系結至主機上的實體網路介面卡，或
- 系結至主機上的內部虛擬網路。
範例格式： -VLanEnabled -VLanMode "Access" -VLANID 35
| Type: | UInt16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VLanMode
指定虛擬機器主機上的虛擬 LAN (VLAN) 是否支援單一 VLAN (存取模式) 或跨多個 VLAN 的流量， (主幹模式) 。 有效值為：Access、主幹。
| Type: | VlanMode |
| Accepted values: | Access, Trunk, Invalid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VLanTrunkID
指派 1-4094 範圍之間的數字識別元清單至 Hyper-V 主機上的實體網路介面卡。
範例格式： -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
| Type: | UInt16[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostNetworkAdapter
指定部署在該主機上之虛擬機器可連線的主機上的實體網路介面卡物件。
範例格式： -VMHostNetworkAdapter $VMHostNIC
| Type: | HostNetworkAdapter |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
輸出
VMHostNetworkAdapter
此 Cmdlet 會傳回 VMHostNetworkAdapter 物件。