Get-VMSwitchExtensionPortData
Retrieves the status of a virtual switch extension feature applied to a virtual network adapter.
Syntax
Get-VMSwitchExtensionPortData
[-VMName] <String[]>
[-VMNetworkAdapterName <String>]
[-CimSession <CimSession[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential[]>]
[-FeatureName <String[]>]
[-FeatureId <Guid[]>]
[-Extension <VMSwitchExtension[]>]
[-ExtensionName <String[]>]
[<CommonParameters>] Get-VMSwitchExtensionPortData
[-VMNetworkAdapter] <VMNetworkAdapterBase[]>
[-FeatureName <String[]>]
[-FeatureId <Guid[]>]
[-Extension <VMSwitchExtension[]>]
[-ExtensionName <String[]>]
[<CommonParameters>] Get-VMSwitchExtensionPortData
[-ManagementOS]
[-VMNetworkAdapterName <String>]
[-CimSession <CimSession[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential[]>]
[-FeatureName <String[]>]
[-FeatureId <Guid[]>]
[-Extension <VMSwitchExtension[]>]
[-ExtensionName <String[]>]
[<CommonParameters>] Get-VMSwitchExtensionPortData
[-ExternalPort]
[-SwitchName <String>]
[-CimSession <CimSession[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential[]>]
[-FeatureName <String[]>]
[-FeatureId <Guid[]>]
[-Extension <VMSwitchExtension[]>]
[-ExtensionName <String[]>]
[<CommonParameters>] Get-VMSwitchExtensionPortData
[-VMNetworkAdapterName <String>]
[-VM] <VirtualMachine[]>
[-FeatureName <String[]>]
[-FeatureId <Guid[]>]
[-Extension <VMSwitchExtension[]>]
[-ExtensionName <String[]>]
[<CommonParameters>] Description
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.
Examples
Example 1
PS C:\> Get-VMSwitchExtensionPortData VM1 -FeatureId eb29f0f2-f5dc-45c6-81bb-3cd9f219bbbbGets 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.
Parameters
-CimSession
Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet. The default is the current session on the local computer.
| Type: | CimSession[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ComputerName
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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Specifies one or more user accounts that have permission to perform this action. The default is the current user.
| Type: | PSCredential[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Extension
Specifies the virtual switch extension for which status is to be retrieved.
| Type: | VMSwitchExtension[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExtensionName
Specifies the name of the virtual switch extension for which status is to be retrieved.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExternalPort
Specifies the virtual switch port connected to the external network adapter.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FeatureId
Specifies the unique identifier of the feature supported by the virtual switch extension.
| Type: | Guid[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FeatureName
Specifies the name of the feature supported by the virtual switch extension.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ManagementOS
Specifies that the status is to be retrieved from the management (i.e. parent, or host) operating system.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SwitchName
Specifies the name of the virtual switch.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VM
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.
| Type: | VirtualMachine[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMName
Specifies the name of the virtual machine.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMNetworkAdapter
Specifies the virtual machine network adapter.
| Type: | VMNetworkAdapterBase[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMNetworkAdapterName
Specifies the name of the virtual machine network adapter.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Outputs
Microsoft.HyperV.PowerShell.VMSwitchExtensionPortData