共用方式為

Get-SCVirtualNetworkAdapter

  • 參考
模組:
VirtualMachineManager

從虛擬機器、虛擬機器範本或硬體設定檔取得 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 來擷取。