Get-Stat Command | Vmware PowerCLI Reference

Get-Stat

This cmdlet retrieves the statistical information available on a vCenter Server system for each provided entity. For example, if the CPU parameter is set to $true, collects the average CPU usage and the average CPU usagemhz counters as appropriate for each entity. If the Stat parameter is specified, collects all provided named stats counters. Counters are provided using a dotted notation of the form "counter group"."counter name"."rollup type". For example: "cpu.usage.min". The cmdlet uses the Start time, if provided, and the Finish time, if provided, along with the MaxSamples, if provided, to bound the data collection. If intervalSecs is provided, the closest matching available interval is used. For each statistics sample on the server, the cmdlet returns a Sample object. The Instance property of the Sample object shows the serial number of the device for which a statistics value is taken. If the Instance property is empty ("), this indicates that the statistics sample contains an average statistic value for all specified devices. If you are connected to a vCenter Server and Get-Stat is run for a host entity, the cmdlet returns only the statistics available on the vCenter Server.

Syntax

Get-Stat
-Entity < VIObject[] >
[-Common ]
[-Cpu ]
[-Disk ]
[-Finish < DateTime > ]
[-Instance < String[] > ]
[-IntervalMins < Int32[] > ]
[-IntervalSecs < Int32[] > ]
[-MaxSamples < Int32 > ]
[-Memory ]
[-Network ]
[-ProgressAction < ActionPreference > ]
[-Realtime ]
[-Server < VIServer[] > ]
[-Start < DateTime > ]
[-Stat < String[] > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
Entity VIObject[] named
  • pipeline
  • wildcards
Specifies the objects (such as virtual machine, virtual machine host, resource pool, and so on) whose statistics you want to retrieve.
optional Common SwitchParameter named
Indicates whether the command collects common CPU, disk, memory and network statistics.
optional Cpu SwitchParameter named
Indicates whether the command collects common CPU statistics, such as the average CPU usage and average CPU usagemhz counters as appropriate for each entity.
optional Disk SwitchParameter named
Indicates whether the command collects common disk statistics, such as the average disk usage, average disk read and average disk write counters as appropriate for each entity.
optional Finish DateTime named
Specifies the end of the time range for which you want to collect statistics. The valid format is dd/mm/yyyy.
optional Instance String[] named
Specifies the Instance property of the statistics you want to retrieve.
optional IntervalMins Int32[] named
Specifies one or more intervals in minutes of the statistics samples you want to retrieve. The closest available statistics interval is taken. To retrieve statistics samples for all available intervals, pass *. If the IntervalMins parameter is not specified, the samples with the best sample rate are retrieved. A best sample rate is the highest sample rate, whose relevant period contains the relevant periods for all other sample rates. A relevant period is the period that starts no earlier than the oldest sample still retained, and is a subset of a query period specified by the user.
optional IntervalSecs Int32[] named
Specifies one or more intervals in seconds of the statistics samples you want to retrieve. The closest available statistics interval is taken. To retrieve statistics samples for all available intervals, pass *.
optional MaxSamples Int32 named
Specifies the maximum number of samples for each statistic.
optional Memory SwitchParameter named
Indicates whether the command collects common memory statistics, such as the mem usage, mem vmmemctl, mem active and mem granted counters as appropriate for each entity.
optional Network SwitchParameter named
Indicates whether the command collects common network statistics, such as the average network usage, average network transmitted and average network received counters as appropriate for each entity.
optional ProgressAction ActionPreference named
optional Realtime SwitchParameter named
Indicates whether the command collects real time statistics.
optional Server VIServer[] named
  • wildcards
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.
optional Start DateTime named
Specifies the beginning of the time range for which you want to collect statistics. The valid format is dd/mm/yyyy.
optional Stat String[] named
  • wildcards
Specifies the identifiers of the statistics you want to retrieve. Counters are provided using a dotted notation of the form "counter group"."counter name"."rollup type". For example, "cpu.usage.min".

Output

VMware.VimAutomation.ViCore.Types.V1.Stat.LongSample

Examples

Example 1

Get-Stat -Entity $VM -Start 5/5/2013 -Finish 7/10/2013 -Disk -IntervalSecs 300

Prints the disk statistics for the specified time interval for the first virtual machine, retrieved by the Get-VM cmdlet.

Example 2

Get-Stat -Entity $MyVMHost -Cpu -Instance 0

Retrieves the CPU statistics for the first processor of a multiprocessor host.

Example 3

Get-VMHost -Name "MyVMHost" | Get-Stat -Network -IntervalSecs 20

Retrieves the network usage statistics for the specified host for the specified time interval.

Example 4

Get-VM -Name "MyVM" | Get-Stat -Stat "mem.usage.average" -Start $MyStartDateTime -Finish $MyFinishDateTime -MaxSamples 10

Retrieves the average memory usage statistics for the specified virtual machine between the specified start and finish date and time. The maximum number of retrieved samples is limited to 10.

Example 5

Get-VM -Name "MyVM" | Get-Stat -CPU -Memory -Realtime

Retrieves the real-time CPU and memory usage statistics for the specified virtual machine.

Example 6

Get-VMHost -Name "MyVMHost" | Get-Stat -Common

Retrieves the common statistics for the specified host.

Example 7

Get-Stat -Entity "MyVMHost" -Disk

Retrieves the disk usage statistics for the specified host.

Related Commands

Stat

This cmdlet retrieves the statistical information available on a vCenter Server system.

StatInterval

This cmdlet retrieves the available statistics intervals and filters them using the provided parameters.

This cmdlet creates a statistics interval with the specified parameters.

This cmdlet removes the statistics interval specified by the provided sampling period or name.

This cmdlet changes the statistics interval that is specified by the provided parameters.

StatType

This cmdlet retrieves the available statistics types for a inventory object.