Get-VMNetworkAdapter

Get-VMNetworkAdapter

Gets the virtual network adapters of a virtual machine, snapshot, management operating system, or of a virtual machine and management operating system.

语法

Parameter Set: VMName
Get-VMNetworkAdapter [-VMName] <String[]> [[-Name] <String> ] [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-IsLegacy <Boolean> ] [ <CommonParameters>]

Parameter Set: All
Get-VMNetworkAdapter [[-Name] <String> ] -All [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [ <CommonParameters>]

Parameter Set: ManagementOS
Get-VMNetworkAdapter [[-Name] <String> ] -ManagementOS [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-SwitchName <String> ] [ <CommonParameters>]

Parameter Set: VMObject
Get-VMNetworkAdapter [-VM] <VirtualMachine[]> [[-Name] <String> ] [-IsLegacy <Boolean> ] [ <CommonParameters>]

Parameter Set: VMSnapshot
Get-VMNetworkAdapter [-VMSnapshot] <VMSnapshot> [[-Name] <String> ] [ <CommonParameters>]

详细说明

The Get-VMNetworkAdapter cmdlet gets the virtual network adapters of the specified virtual machine, snapshot, or management operating system.

参数

-CimSession<Microsoft.Management.Infrastructure.CimSession[]>

在远程会话中或远程计算机上运行该 cmdlet。输入计算机名或会话对象,如 New-cimsessionGet-cimsession cmdlet 的输出。默认为本地计算机上的当前会话。

别名

none

是否必需?

false

在哪里?

named

默认值

none

是否接受管道输入?

false

是否接受通配符?

false

-ComputerName<String[]>

Specifies one or more Hyper-V hosts on the virtual network adapters are to be retrieved. NetBIOS names, IP addresses, and fully qualified domain names are allowable. The default is the local computer. Use localhost or a dot (.) to specify the local computer explicitly.

别名

none

是否必需?

false

在哪里?

named

默认值

none

是否接受管道输入?

false

是否接受通配符?

false

-Credential<System.Management.Automation.PSCredential[]>

Specifies one or more user accounts that have permission to perform this action. The default is the current user.

别名

none

是否必需?

false

在哪里?

named

默认值

none

是否接受管道输入?

false

是否接受通配符?

false

-IsLegacy<Boolean>

Specify as $TRUE to retrieve only legacy network adapters, or as $FALSE to retrieve only Hyper-V-specific network adapters. If not specified, virtual network adapters of both types are retrieved.

别名

none

是否必需?

false

在哪里?

named

默认值

none

是否接受管道输入?

false

是否接受通配符?

false

-ManagementOS

Specifies the management operating system, i.e. the virtual machine host operating system.

别名

none

是否必需?

true

在哪里?

named

默认值

none

是否接受管道输入?

false

是否接受通配符?

false

-Name<String>

Specifies the name of the network adapter to be retrieved.

别名

VMNetworkAdapterName

是否必需?

false

在哪里?

2

默认值

none

是否接受管道输入?

false

是否接受通配符?

false

-VM<VirtualMachine[]>

Specifies the virtual machine whose virtual network adapters are to be retrieved. . The asterisk, “*”, is the wildcard. If it is specified the cmdlet returns virtual network adapters from every virtual machine in the system.

别名

none

是否必需?

true

在哪里?

1

默认值

none

是否接受管道输入?

True (ByValue)

是否接受通配符?

false

-VMName<String[]>

Specifies the name of the virtual machine whose network adapters are to be retrieved.

别名

none

是否必需?

true

在哪里?

1

默认值

none

是否接受管道输入?

True (ByValue)

是否接受通配符?

false

-VMSnapshot<VMSnapshot>

Specifies the snapshot whose network adapters are to be retrieved.

别名

VMCheckpoint

是否必需?

true

在哪里?

1

默认值

none

是否接受管道输入?

True (ByValue)

是否接受通配符?

false

-SwitchName<String>

Specifies the name of the virtual switch whose network adapters are to be retrieved. (This parameter is available only for virtual network adapters in the management operating system.)

别名

none

是否必需?

false

在哪里?

named

默认值

none

是否接受管道输入?

false

是否接受通配符?

false

-All

Specifies all virtual network adapters in the system, regardless of whether the virtual network adapter is in the management operating system or in a virtual machine.

别名

none

是否必需?

true

在哪里?

named

默认值

none

是否接受管道输入?

false

是否接受通配符?

false

<CommonParameters>

此 cmdlet 支持常见的参数:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息,请参阅 TechNet 上的 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

输入

输入类型是可以传送到 cmdlet 的对象的类型。

输出

输出类型是 cmdlet 发出的对象的类型。

  • Microsoft.HyperV.PowerShell.VMInternalNetworkAdapter if ManagementOS is specified; Microsoft.HyperV.PowerShell.VMInternalNetworkAdapter and Microsoft.HyperV.PowerShell.VMNetworkAdapter if All is specified;Microsoft.HyperV.PowerShell.VMNetworkAdapter in all other cases.

示例

Example 1

Gets virtual network adapters from all virtual machines on the local Hyper-V host.

PS C:\> Get-VMNetworkAdapter –VMName *

Example 2

Gets the virtual network adapters in the ManagementOS (i.e. the local Hyper-V host).

PS C:\> Get-VMNetworkAdapter -ManagementOS

Example 3

Gets virtual network adapters from all virtual machines as well as the management operating system.

PS C:\> Get-VMNetworkAdapter -All