Debug-Virtual Machine Queue Operation

Debugs VMQ/VMMQ traffic.

Syntax

Debug-VirtualMachineQueueOperation
     [[-HostName] <String>]
     [[-MgmtIp] <String>]
     [[-Creds] <PSCredential>]
     [-VMName] <String>
     [-VMNetworkAdapterName] <String>
     [[-SampleCount] <UInt32>]
     [<CommonParameters>]

Description

The Debug-VirtualMachineQueueOperation cmdlet analyzes virtual machine queue (VMQ) and VMMQ traffic. You can use this cmdlet to identify whether VMQ/VMMQ is degrading throughput or is contributing to high utilization on some cores.

Examples

Example 1: Debug VMMQ on a remote computer

PS C:\> $Cred = Get-Credential
PS C:\> Debug-VirtualMachineQueueOperation -HostName "NCHost.corp.com" -MgmtIp "10.123.176.108" -Creds $Cred -VMName "MuxVM" -VMNetworkAdapterName "Ethernet"

The first command gets the credentials for the current user, and then stores them in the $Cred variable.

The second command gets debug information for VMMQ on a remote computer.

Example 2: Debug VMMQ on the local host

PS C:\> $Cred = Get-Credential
PS C:\> Debug-VirtualMachineQueueOperation -VMName "MuxVM" -VMNetworkAdapterName "Ethernet" -SampleCount 90

The first command gets the credentials for the current user, and then stores them in the $Cred variable.

The second command gets debug information for VMMQ on the local host.

Required Parameters

-VMName

Specifies the name of the virtual machine to analyze.

Type: String
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-VMNetworkAdapterName

Specifies the name of the virtual machine network adapter to analyze.

Type: String
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Optional Parameters

-Creds

Specifies the credentials to use to connect to a remote host.

Type: PSCredential
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-HostName

Specifies the remote host on which to run the diagnostics.

Type: String
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MgmtIp

Specifies the management IP address of the remote host.

Type: String
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SampleCount

Specifies the number of seconds to analyze network traffic.

Type: UInt32
Position: 5
Default value: None
Accept pipeline input: False
Accept wildcard characters: False