共用方式為

Get-SCVMHostNetworkAdapter

  • 參考
模組:
VirtualMachineManager

取得 VMM 主機上的實體網路適配器物件。

語法

Get-SCVMHostNetworkAdapter
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [<CommonParameters>]
Get-SCVMHostNetworkAdapter
   -ID <Guid>
   [[-Name] <String>]
   [<CommonParameters>]
Get-SCVMHostNetworkAdapter
   -VMHost <Host>
   [[-Name] <String>]
   [<CommonParameters>]

Description

Get-SCVMHostNetworkAdapter Cmdlet 會在 Virtual Machine Manager （VMM） 所管理的主機上取得一或多個實體網路適配器物件。

範例

範例 1：取得指定主機上的所有實體網路適配器

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com" 
PS C:\> $HostAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost
PS C:\> $HostAdapter | select -property Name, ConnectionState

第一個命令會取得名為 VMHost01 的主機物件，並將物件儲存在 $VMHost 變數中。

第二個命令會從 VMHost01 取得所有實體網路適配器對象，然後將物件儲存在$HostAdapter變數中。

第三個命令會顯示每個配接器的名稱和連線狀態。

範例 2：取得 VMM 資料庫中的所有實體網路適配器

PS C:\> Get-SCVMHostNetworkAdapter | Format-List Name, MacAddress, VMHost, MaxBandwidth

此命令會取得 VMM 伺服器所管理之所有主機上的所有實體網路適配器物件，並顯示每個適配卡的名稱、其 MAC 位址、主機名和最大頻寬。

範例 3：依名稱從特定主機取得實體網路適配器

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com" 
PS C:\> $HostAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter01"
PS C:\> $HostAdapter | Format-List -property Name,VLANEnabled,VLANMode

第一個命令會取得名為 VMHost01 的主機物件，並將物件儲存在 $VMHost 變數中。

第二個命令會從 VMHost01 取得名為 HostAdapter01 的網路適配器物件，並將物件儲存在$HostAdapter變數中。

第三個命令會將儲存在 $HostAdapter 中的配接器對象傳遞至 Format-List Cmdlet，以顯示名稱、是否啟用虛擬 LAN，以及 VLAN 模式的目前值（主幹或 Access）。

範例 4：取得名稱中包含 「Broadcom」 的每個主機網路適配器

PS C:\> Get-SCVMHostNetworkAdapter -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -match "Broadcom" } | Format-List -Property Name,IPAddresses

此命令會從 VMMServer01 取得主機網路適配器物件，其中包含名稱中的字串 “Broadcom”。 然後顯示每個適配卡的名稱和IP位址。

參數

-ID

將數值識別子指定為特定物件的全域唯一標識碼或 GUID。

類型:Guid
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Name

指定 VMM 物件的名稱。

類型:String
Position:0
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-VMHost

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

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

類型:Host
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-VMMServer

指定 VMM 伺服器物件。

類型:ServerConnection
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

輸出

HostNetworkAdapter

Cmdlet 會傳回 HostNetworkAdapter 物件。