Debug-VirtualMachineQueueOperation

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