Get-VMSwitchExtensionPortData

Get-VMSwitchExtensionPortData

Retrieves the status of a virtual switch extension feature applied to a virtual network adapter.

语法

Parameter Set: VMName
Get-VMSwitchExtensionPortData [-VMName] <String[]> [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-Extension <VMSwitchExtension[]> ] [-ExtensionName <String[]> ] [-FeatureId <Guid[]> ] [-FeatureName <String[]> ] [-VMNetworkAdapterName <String> ] [ <CommonParameters>]

Parameter Set: ExternalPort
Get-VMSwitchExtensionPortData -ExternalPort [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-Extension <VMSwitchExtension[]> ] [-ExtensionName <String[]> ] [-FeatureId <Guid[]> ] [-FeatureName <String[]> ] [-SwitchName <String> ] [ <CommonParameters>]

Parameter Set: ManagementOS
Get-VMSwitchExtensionPortData -ManagementOS [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-Extension <VMSwitchExtension[]> ] [-ExtensionName <String[]> ] [-FeatureId <Guid[]> ] [-FeatureName <String[]> ] [-VMNetworkAdapterName <String> ] [ <CommonParameters>]

Parameter Set: ResourceObject
Get-VMSwitchExtensionPortData [-VMNetworkAdapter] <VMNetworkAdapterBase[]> [-Extension <VMSwitchExtension[]> ] [-ExtensionName <String[]> ] [-FeatureId <Guid[]> ] [-FeatureName <String[]> ] [ <CommonParameters>]

Parameter Set: VMObject
Get-VMSwitchExtensionPortData [-VM] <VirtualMachine[]> [-Extension <VMSwitchExtension[]> ] [-ExtensionName <String[]> ] [-FeatureId <Guid[]> ] [-FeatureName <String[]> ] [-VMNetworkAdapterName <String> ] [ <CommonParameters>]

详细说明

The Get-VMSwitchExtensionPortData cmdlet retrieves the status of a virtual switch extension feature applied to a virtual network adapter. This port feature data surfaces runtime information and statistics on a per-port basis.

参数

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

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

别名	none
是否必需？	false
在哪里？	named
默认值	none
是否接受管道输入？	false
是否接受通配符？	false

-ComputerName<String[]>

Specifies one or more Hyper-V hosts on which the status of a virtual switch extension applied to a virtual network adapter is 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

-Extension<VMSwitchExtension[]>

Specifies the virtual switch extension for which status is to be retrieved.

别名	none
是否必需？	false
在哪里？	named
默认值	none
是否接受管道输入？	false
是否接受通配符？	false

-ExtensionName<String[]>

Specifies the name of the virtual switch extension for which status is to be retrieved.

别名	none
是否必需？	false
在哪里？	named
默认值	none
是否接受管道输入？	false
是否接受通配符？	false

-ExternalPort

Specifies the virtual switch port connected to the external network adapter.

别名	none
是否必需？	true
在哪里？	named
默认值	none
是否接受管道输入？	false
是否接受通配符？	false

-FeatureId<Guid[]>

Specifies the unique identifier of the feature supported by the virtual switch extension.

别名	none
是否必需？	false
在哪里？	named
默认值	none
是否接受管道输入？	false
是否接受通配符？	false

-FeatureName<String[]>

Specifies the name of the feature supported by the virtual switch extension.

别名	none
是否必需？	false
在哪里？	named
默认值	none
是否接受管道输入？	false
是否接受通配符？	false

-ManagementOS

Specifies that the status is to be retrieved from the management (i.e. parent, or host) operating system.

别名	none
是否必需？	true
在哪里？	named
默认值	none
是否接受管道输入？	false
是否接受通配符？	false

-SwitchName<String>

Specifies the name of the virtual switch.

别名	none
是否必需？	false
在哪里？	named
默认值	none
是否接受管道输入？	false
是否接受通配符？	false

-VM<VirtualMachine[]>

Specifies an array of virtual machine objects. The cmdlet gets the status of the virtual switch extension for the virtual machines that you specify. To obtain a virtual machine object, use the Get-VM cmdlet.

别名	none
是否必需？	true
在哪里？	1
默认值	none
是否接受管道输入？	True (ByValue)
是否接受通配符？	false

-VMName<String[]>

Specifies the name of the virtual machine.

别名	none
是否必需？	true
在哪里？	1
默认值	none
是否接受管道输入？	True (ByValue)
是否接受通配符？	false

-VMNetworkAdapter<VMNetworkAdapterBase[]>

Specifies the virtual machine network adapter.

别名	none
是否必需？	true
在哪里？	1
默认值	none
是否接受管道输入？	True (ByValue)
是否接受通配符？	false

-VMNetworkAdapterName<String>

Specifies the name of the virtual machine network adapter.

别名	none
是否必需？	false
在哪里？	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 发出的对象的类型。

示例

Example 1

Gets the port feature data with ID eb29f0f2-f5dc-45c6-81bb-3cd9f219bbbb from the sample forwarding extension on the virtual network adapter in virtual machine VM1.

PS C:\> Get-VMSwitchExtensionPortData VM1 -FeatureId eb29f0f2-f5dc-45c6-81bb-3cd9f219bbbb