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-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
-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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour