Get-SCVirtualNetworkAdapter
從虛擬機、虛擬機範本或硬體配置檔取得 VMM 虛擬網路適配器物件。
語法
Get-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
[-All]
[-ParentTypeVMOrHost]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Get-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
-HardwareProfile <HardwareProfile>
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Get-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
-VM <VM>
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Get-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
-VMTemplate <Template>
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Get-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
-VMHost <Host>
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Get-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
[-ID] <Guid>
[[-Name] <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Description
Get-SCVirtualNetworkAdapter Cmdlet 會從虛擬機物件、虛擬機範本物件或 Virtual Machine Manager （VMM） 環境中的硬體配置檔物件取得一或多個虛擬網路適配器物件。
範例
範例 1：從虛擬機取得虛擬網路適配器
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCVirtualNetworkAdapter -VM $VM第一個命令會取得名為 VM01 的虛擬機物件，並將物件儲存在$VM變數中。
第二個命令會取得 VM01 上的所有虛擬網路適配器物件，並向用戶顯示適配卡的相關信息。
範例 2：從虛擬機範本取得虛擬網路適配器
PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> Get-SCVirtualNetworkAdapter -Template $VMTemplate第一個命令會從 VMM 連結庫取得所有虛擬機範本對象、選取名為 VMTemplate01 的範本物件，並將物件儲存在$VMTemplate 變數中。
最後一個命令會取得所有虛擬網路適配器物件 VMTemplate01，並向使用者顯示這些適配卡的相關信息。
範例 3：從硬體配置檔取得虛擬網路適配器
PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> Get-SCVirtualNetworkAdapter -HardwareProfile $HWProfile第一個命令會取得 VMM 連結庫中的所有硬體配置檔對象、選取名為 NewHWProfile01 的設定檔物件，然後將物件儲存在$HWProfile變數中。
第二個命令會取得所有虛擬網路適配器物件NewHWProfile01，並向用戶顯示這些適配卡的相關信息。
參數
-All
指出這個 Cmdlet 會取得與父對象無關的所有次級物件。
例如，命令 Get-SCVirtualDiskDrive -All 會取得所有虛擬磁碟驅動器物件，而不論每個虛擬磁碟驅動器對象相關聯的虛擬機物件或範本對象為何。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-HardwareProfile
指定硬體配置檔物件。
| 類型: | HardwareProfile |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ID
將數值識別子指定為特定物件的全域唯一標識碼或 GUID。
| 類型: | Guid |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Name
指定網路物件的名稱。
| 類型: | String |
| Position: | 1 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-OnBehalfOfUser
指定用戶名稱。 這個 Cmdlet 代表此參數指定的用戶運作。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-OnBehalfOfUserRole
指定使用者角色。 若要取得使用者角色，請使用 Get-SCUserRole Cmdlet。 這個 Cmdlet 代表此參數指定的使用者角色運作。
| 類型: | UserRole |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ParentTypeVMOrHost
表示父類型為虛擬機或主機。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-VM
指定虛擬機物件。
| 類型: | VM |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | 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 |
-VMTemplate
指定用來建立虛擬機的 VMM 範本物件。
| 類型: | Template |
| 別名: | Template |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
輸出
VirtualNetworkAdapter
此 Cmdlet 會傳回 VirtualNetworkAdapter 物件。
備註
- 需要 VMM 虛擬機物件、虛擬機範本物件或硬體配置檔物件，可以使用 Get-SCVirtualMachine、Get-SCVMTemplate或 Get-SCHardwareProfile Cmdlet 來擷取。