Add-SCVMHostNetworkAdapter
將 VMM 所管理主機上的實體網路適配器新增至虛擬網路。
Syntax
Add-SCVMHostNetworkAdapter
-VirtualNetwork <VirtualNetwork>
[-VLanEnabled]
[-VLanMode <VlanMode>]
[-VLanID <UInt16>]
[-VLanTrunkID <UInt16[]>]
[-VMHostNetworkAdapter] <HostNetworkAdapter>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Description
Add-SCVMHostNetworkAdapter Cmdlet 會將實體網路適配器新增 (也稱為網路介面卡,或 Virtual Machine Manager 所管理主機上的 NIC) , (VMM) 至虛擬網路。 該主機上的每個虛擬機也可以透過虛擬網路適配器連線到該虛擬網路。
主機上設定的虛擬網路可連線至部署在該主機虛擬機器上的多個虛擬網路介面卡。
適用於 System Center 2019 和更新版本的 VMM 包含在主機上設定一或多個虛擬局域網路 (VLAN) 的虛擬網路支援。 您可以使用 Add-SCVMHostNetworkAdapter Cmdlet 或 Set-SCVMHostNetworkAdapter Cmdlet,在主機上設定單一 VLAN 或多個 VLAN。 若要在虛擬機上設定對應的 VLAN 設定,請使用 New-SCVirtualNetworkAdapter Cmdlet 或 Set-SCVirtualNetworkAdapter Cmdlet。
如需每種 VLAN 類型的說明,請參閱此指令程式的範例。
範例
範例 1:將實體主機網路適配器新增至虛擬網路
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork01"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter01"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter
第一個命令會取得名為 VMHost01 的主機物件,並將物件儲存在$VMHost變數中。
第二個命令會取得 VMHost01 上名為 ExternalVirtualNetwork01 的虛擬網路物件,並將物件儲存在 $VirtualNetwork 變數中。
第三個命令會取得 VMHost01 上名為 HostAdapter01 的實體網路適配器物件,並將物件儲存在$VMHostNetworkAdapter變數中。
最後一個命令會將 HostAdapter01 新增至 ExternalVirtualNetwork01。
注意:每個虛擬網路只能新增一個實體主機適配卡。 因此,如果配接器已經與指定的虛擬網路相關聯,則最後一個命令將會失敗。 若要將新的適配卡新增至虛擬網路,您必須先移除現有的主機適配卡。
範例 2:將實體主機網路適配器新增至使用「主幹」模式的 VLAN
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalNetwork02"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter02"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
第一個命令會取得名為 VMHost02 的主機物件,並將物件儲存在$VMHost變數中。
第二個命令會取得 VMHost02 上名為 ExternalNetwork02 的虛擬網路物件,並將物件儲存在$VirtualNetwork變數中。
第三個命令會取得 VMHost02 上名為 HostAdapter02 的網路適配器物件,並將配接器物件儲存在$VMHostNetworkAdapter變數中。
最後一個命令會將 HostAdapter02 新增至虛擬網路 ExternalNetwork02,並使用 802.1Q 標記的 VLAN 1、2、100、200 和 1124,從 ExternalNetwork02 存取外部網路裝置。
注意:每個虛擬網路只能新增一個主機適配卡,因此,如果配接器已經與指定的虛擬網路相關聯,則最後一個命令將會失敗。
範例 3:將實體主機網路適配器新增至使用「存取」模式的 VLAN
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork03"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter03"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLanEnabled -VLanMode "Access" -VLanID 22
第一個命令會取得名為 VMHost03 的主機物件,並將物件儲存在 $VMHost 變數中。
第二個命令會取得 VMHost03 上名為 ExternalNetwork03 的虛擬網路物件,並將物件儲存在 $VirtualNetwork 變數中。
第三個命令會取得 VMHost03 上名為 HostAdapter03 的網路適配器物件,並將配接器物件儲存在 $VMHostNetworkAdapter 變數中。
最後一個命令會將 HostAdapter03 新增至虛擬網路 ExternalNetwork03,並將 ExternalNetwork03 的存取限制為 VLANID 22。
注意:每個虛擬網路只能新增一個主機適配卡,因此,如果配接器已經與指定的虛擬網路相關聯,則最後一個命令將會失敗。
注意:此範例假設您的主機已連線到 VLAN,否則請確定您的主機有兩個網路適配器。 如果您的主機有單一網路適配器,請將適配卡指派給 VMM 伺服器無法使用的 VLAN,將會防止 VMM 管理主機。 如果先在伺服器上安裝 Microsoft Loopback Adapter,就可以在只有一張網路介面卡的主機上執行此範例中的步驟。
參數
-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 提示的標識碼) 。 此參數可讓您稽核 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 |
-VirtualNetwork
指定虛擬網路物件。
Type: | VirtualNetwork |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
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: | SwitchParameter |
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 物件。