The Get-NetAdapterVmq PowerShell command is a useful tool for managing virtual machine queue (VMQ) settings on network adapters. This command is part of the Windows PowerShell Networking module, which provides a set of cmdlets for managing network adapters, IP addresses, and other networking components. With the Get-NetAdapterVmq command, you can view and configure VMQ settings on network adapters, such as the number of queues, the number of queues per processor, and the queue size.
Syntax
The syntax for the Get-NetAdapterVmq command is as follows:
Get-NetAdapterVmq [-Name] <String[]> [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-ComputerName <String[]>] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
Parameters
The Get-NetAdapterVmq command has the following parameters:
| Parameter | Description |
|---|---|
| Name | Specifies the name of the network adapter for which to view or configure VMQ settings. |
| CimSession | Specifies an existing CIM session to use for the operation. |
| ThrottleLimit | Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If this parameter is omitted or a value of 0 is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. |
| AsJob | Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete. |
| ComputerName | Specifies the name of the computer on which to run the cmdlet. The default is the local computer. |
| PassThru | Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output. |
| WhatIf | Shows what would happen if the cmdlet runs. The cmdlet is not run. |
| Confirm | Prompts you for confirmation before running the cmdlet. |
Inputs
The Get-NetAdapterVmq command accepts the following input types:
- System.String[]
- System.Management.Automation.CimSession[]
- System.Int32
- System.Management.Automation.Job[]
- System.String[]
- System.Management.Automation.SwitchParameter
- System.Management.Automation.SwitchParameter
- System.Management.Automation.SwitchParameter
Outputs
The Get-NetAdapterVmq command returns the following output types:
- Microsoft.Management.Infrastructure.CimInstance#root/StandardCimv2/MSFT_NetAdapterVmqSettingData
- System.Object
Examples
The following example shows how to view the VMQ settings for a network adapter named “Ethernet1”:
Get-NetAdapterVmq -Name “Ethernet1”
The following example shows how to configure the number of queues on a network adapter named “Ethernet1”:
Get-NetAdapterVmq -Name “Ethernet1” | Set-NetAdapterVmq -NumberOfQueues 4
Tips
Here are some tips for using the Get-NetAdapterVmq command:
- Make sure you specify the correct network adapter name when using the Get-NetAdapterVmq command.
- You can use the Get-NetAdapterVmq command to view the current VMQ settings on a network adapter.
- You can use the Set-NetAdapterVmq command to configure the VMQ settings on a network adapter.
- You can use the Get-NetAdapterVmqStatistics command to view the VMQ statistics for a network adapter.
- You can use the Reset-NetAdapterVmqStatistics command to reset the VMQ statistics for a network adapter.