Get-VMSwitchExtensionPortData
Retrieves the status of a virtual switch extension feature applied to a virtual network adapter.
Syntax
Get-VMSwitchExtensionPortData
[-VMName] <String[]>
[-ComputerName <String[]>]
[-Extension <VMSwitchExtension[]>]
[-ExtensionName <String[]>]
[-FeatureId <Guid[]>]
[-FeatureName <String[]>]
[-Passthru]
[-VMNetworkAdapterName <String>]
Get-VMSwitchExtensionPortData
[-SwitchName] <String>
[-ComputerName <String[]>]
[-Extension <VMSwitchExtension[]>]
[-ExtensionName <String[]>]
[-FeatureId <Guid[]>]
[-FeatureName <String[]>]
[-Passthru]
[-ExternalPort]
Get-VMSwitchExtensionPortData
[-ComputerName <String[]>]
[-Extension <VMSwitchExtension[]>]
[-ExtensionName <String[]>]
[-FeatureId <Guid[]>]
[-FeatureName <String[]>]
[-Passthru]
[-VMNetworkAdapterName <String>]
[-ManagementOS]
Get-VMSwitchExtensionPortData
[-VM] <VirtualMachine[]>
[-Extension <VMSwitchExtension[]>]
[-ExtensionName <String[]>]
[-FeatureId <Guid[]>]
[-FeatureName <String[]>]
[-Passthru]
[-VMNetworkAdapterName <String>]
Get-VMSwitchExtensionPortData
[-VMNetworkAdapter] <VMNetworkAdapterBase[]>
[-Extension <VMSwitchExtension[]>]
[-ExtensionName <String[]>]
[-FeatureId <Guid[]>]
[-FeatureName <String[]>]
[-Passthru]
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-3cd9f219bbbb
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.
Parameters
-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 |
-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 interface card.
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 |
-Passthru
Specifies that an object is to be passed through to the pipeline representing the status to be retrieved.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SwitchName
Specifies the name of the virtual switch.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VM
Type: | VirtualMachine[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMName
Specifies the name of the virtual machine.
Type: | String[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMNetworkAdapter
Specifies the virtual machine network adapter.
Type: | VMNetworkAdapterBase[] |
Position: | 1 |
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 |
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for