Get-SCVirtualNetworkAdapter
從虛擬機器、虛擬機器範本或硬體設定檔取得 VMM 虛擬網路介面卡物件。
Syntax
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 會取得所有虛擬磁片磁碟機物件，而不論每個虛擬磁片磁碟機物件相關聯的虛擬機器物件或範本物件為何。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-HardwareProfile
指定硬體設定檔物件。
| Type: | HardwareProfile |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ID
將數值識別碼指定為特定物件的全域唯一識別碼或 GUID。
| Type: | Guid |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
指定網路物件的名稱。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| 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 |
-ParentTypeVMOrHost
表示父類型為虛擬機器或主機。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VM
指定虛擬機器物件。
| Type: | VM |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMHost
指定虛擬機器主機物件。 VMM 支援 Hyper-V 主機、VMware ESX 主機和 Citrix XenServer 主機。
如需每種主機類型的詳細資訊，請參閱 Add-SCVMHost Cmdlet。
| Type: | Host |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMMServer
指定 VMM 伺服器物件。
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMTemplate
指定用來建立虛擬機器的 VMM 範本物件。
| Type: | Template |
| Aliases: | Template |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
輸出
VirtualNetworkAdapter
此 Cmdlet 會傳回 VirtualNetworkAdapter 物件。
備註
- 需要 VMM 虛擬機器物件、虛擬機器範本物件或硬體設定檔物件，其可分別使用 Get-SCVirtualMachine、 Get-SCVMTemplate或 Get-SCHardwareProfile Cmdlet 來擷取。