Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

Reset-VMResourceMetering

Windows Server 2012 R2 and Windows 8.1

Updated: March 3, 2014

Applies To: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

Reset-VMResourceMetering

Resets the resource utilization data collected by Hyper-V resource metering.

Syntax

Parameter Set: ResourcePool
Reset-VMResourceMetering [-ResourcePoolName] <String> [[-ResourcePoolType] <VMResourcePoolType> ] [-ComputerName <String[]> ] [ <CommonParameters>]

Parameter Set: VMName
Reset-VMResourceMetering [-VMName] <String[]> [-ComputerName <String[]> ] [ <CommonParameters>]

Parameter Set: VMObject
Reset-VMResourceMetering [-VM] <VirtualMachine[]> [ <CommonParameters>]




Detailed Description

The Reset-VMResourceMetering cmdlet resets the resource utilization data collected by Hyper-V resource metering.

When this cmdlet is called, the virtual machine or resource pool resource utilization data collected up to current point of time is deleted. Hyper-V continues to collect resource utilization data after reset.

Parameters

-ComputerName<String[]>

Specifies one or more virtual machine hosts for which resource utilization data is to be reset. 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.


Aliases

none

Required?

false

Position?

named

Default Value

.

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ResourcePoolName<String>

Specifies the friendly name of the virtual machine resource pool for which resource utilization data is to be reset.


Aliases

Name

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue, ByPropertyName)

Accept Wildcard Characters?

false

-ResourcePoolType<VMResourcePoolType>

Specifies the resource type of the virtual machine resource pool for which resource utilization data is to be reset.


Aliases

none

Required?

false

Position?

2

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-VM<VirtualMachine[]>

Specifies the virtual machine for which resource utilization data is to be reset.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-VMName<String[]>

Specifies the friendly name of the virtual machine for which resource utilization data is to be reset.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • Microsoft.HyperV.PowerShell.VirtualMachine[]
  • Microsoft.HyperV.PowerShell.VMResourcePoolType

Outputs

The output type is the type of the objects that the cmdlet emits.

  • None

Examples

Example 1

Resets resource utilization data collection on a virtual machine named TestVM.


PS C:\> Reset-VMResourceMetering –VMName TestVM

Example 2

Resets resource utilization data collection for a single resource pool named TestResourcePool of type Memory.


PS C:\> Reset-VMResourceMetering –ResourcePoolName TestResourcePool –ResourcePoolType Memory

Example 3

Resets resource utilization data collection for all supported resource pool types on the virtual machine host.


PS C:\> Get-VMResourcePool –ResourcePoolType @("Processor","VHD","Ethernet","Memory") | Reset-VMResourceMetering

Related topics

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.