Get-PerformanceCounterValue

Get-PerformanceCounterValue

Gets data associated with a specified performance counter.

Syntax

Parameter Set: FromPerformanceData
Get-PerformanceCounterValue [-StartTime] <DateTime> [-EndTime] <DateTime> [-PerformanceCounter] <MonitoringPerformanceData> [ <CommonParameters>]

Detailed Description

Gets data associated with a specified performance counter. You can specify the time period for which you want the collected data.

Parameters

-EndTime<DateTime>

Specifies the ending date and time from which to select the performance counter data.

Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-PerformanceCounter<MonitoringPerformanceData>

Specifies the performance counter from which to select data. You can use the get-performance counter cmdlet to retrieve a performance counter object to supply for this parameter.

Aliases

none

Required?

true

Position?

3

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-StartTime<DateTime>

Specifies the beginning date and time from which to select the performance counter data.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

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

Notes

  • For more information, type "Get-Help Get-PerformanceCounterValue -detailed". For technical information, type "Get-Help Get-PerformanceCounterValue -full".
    When specifying multiple values for a parameter, use commas to separate the values. For example, "<parameter-name> <value1>, <value2>".

Examples

-------------- EXAMPLE 1 --------------

This command uses Get-PerformanceCounter to retrieve all performance counters. It passes the results along the pipeline to Get-PerformanceCounterValue which displays the associated performance data for the period beginning on 1/10/06 and ending on 3/10/07.

C:\PS>get-performancecounter |
get-performancecountervalue -starttime "1/10/06" -endtime "3/10/07"

Get-PerformanceCounter