Debug-VirtualMachineQueueOperation

Reference

Module:: HNVDiagnostics

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.

Parameters

-Creds

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

Type:	PSCredential
Position:	2
Default value:	None
Required:	False
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
Required:	False
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
Required:	False
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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMName

Specifies the name of the virtual machine to analyze.

Type:	String
Position:	3
Default value:	None
Required:	True
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
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

None

Outputs

Object