Reset-VMResourceMetering
Resets the resource utilization data collected by Hyper-V resource metering.
Syntax
VMName (Default)
Reset-VMResourceMetering
[-VMName] <String[]>
[-CimSession <CimSession[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential[]>]
[<CommonParameters>]
ResourcePool
Reset-VMResourceMetering
[-ResourcePoolName] <String>
[[-ResourcePoolType] <VMResourcePoolType>]
[-CimSession <CimSession[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential[]>]
[<CommonParameters>]
VMObject
Reset-VMResourceMetering
[-VM] <VirtualMachine[]>
[<CommonParameters>]
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.
Examples
Example 1
PS C:\> Reset-VMResourceMetering -VMName TestVM
Resets resource utilization data collection on a virtual machine named TestVM.
Example 2
PS C:\> Reset-VMResourceMetering -ResourcePoolName TestResourcePool -ResourcePoolType Memory
Resets resource utilization data collection for a single resource pool named TestResourcePool of type Memory.
Example 3
PS C:\> Get-VMResourcePool -ResourcePoolType @("Processor","VHD","Ethernet","Memory") | Reset-VMResourceMetering
Resets resource utilization data collection for all supported resource pool types on the virtual machine host.
Parameters
-CimSession
Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet. The default is the current session on the local computer.
Parameter properties
Type: | CimSession[] |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
VMName
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | True |
Value from remaining arguments: | False |
ResourcePool
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | True |
Value from remaining arguments: | False |
-ComputerName
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.
Parameter properties
Type: | String[] |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
VMName
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
ResourcePool
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-Credential
Specifies one or more user accounts that have permission to perform this action. The default is the current user.
Parameter properties
Type: | PSCredential[] |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
VMName
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
ResourcePool
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-ResourcePoolName
Specifies the friendly name of the virtual machine resource pool for which resource utilization data is to be reset.
Parameter properties
Type: | String |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Aliases: | Name |
Parameter sets
ResourcePool
Position: | 0 |
Mandatory: | True |
Value from pipeline: | True |
Value from pipeline by property name: | True |
Value from remaining arguments: | False |
-ResourcePoolType
Specifies the resource type of the virtual machine resource pool for which resource utilization data is to be reset.
Parameter properties
Type: | VMResourcePoolType |
Default value: | None |
Accepted values: | Ethernet, Memory, Processor, VHD |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
ResourcePool
Position: | 1 |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | True |
Value from remaining arguments: | False |
-VM
Specifies the virtual machine for which resource utilization data is to be reset.
Parameter properties
Type: | VirtualMachine[] |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
VMObject
Position: | 0 |
Mandatory: | True |
Value from pipeline: | True |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-VMName
Specifies the friendly name of the virtual machine for which resource utilization data is to be reset.
Parameter properties
Type: | String[] |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
VMName
Position: | 0 |
Mandatory: | True |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.