Disable-VMResourceMetering
Disables collection of resource utilization data for a virtual machine or resource pool.
Syntax
VMName (Default)
Disable-VMResourceMetering
[-VMName] <String[]>
[-CimSession <CimSession[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential[]>]
[<CommonParameters>]
ResourcePool
Disable-VMResourceMetering
[-ResourcePoolName] <String>
[[-ResourcePoolType] <VMResourcePoolType>]
[-CimSession <CimSession[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential[]>]
[<CommonParameters>]
VMObject
Disable-VMResourceMetering
[-VM] <VirtualMachine[]>
[<CommonParameters>]
Description
The Disable-VMResourceMetering cmdlet disables collection of resource utilization data for a virtual machine or resource pool.
Calling this cmdlet stops collection of data and deletes data collected up to the point of the call.
After the call, Measure-VM and Measure-VMResourcePool are not usable.
Examples
Example 1
PS C:\> Disable-VMResourceMetering -VMName TestVM
Disables collection of resource utilization data on a virtual machine named TestVM.
Example 2
PS C:\> Get-VM Test* | Disable-VMResourceMetering
Disables collection of resource utilization data on a set of virtual machines whose names begin with the string Test.
Example 3
PS C:\> Disable-VMResourceMetering -ResourcePoolName TestResourcePool -ResourcePoolType Memory
Disables collection of resource utilization data on a resource pool named TestResourcePool of type Memory.
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 Hyper-V hosts on which resource utilization data collection is to be disabled. 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 resource pool on which resource utilization data collection is to be disabled.
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 resource pool on which resource utilization data collection is to be disabled.
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 on which resource utilization data collection is to be disabled.
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 on which resource utilization data collection is to be disabled.
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.