XenApp and XenDesktop 7.6

Get-LogSummary

Sep 10, 2014

Gets operations logged within time intervals inside a date range.

Syntax

Get-LogSummary [-StartDateRange <DateTime>] [-EndDateRange <DateTime>] [-IntervalSeconds <Int64>] [-

GetLowLevelOperations] [-IncludeIncomplete] [-OperationType <OperationType>] [-AdminAddress <String>]

[<CommonParameters>]

Detailed Description

The Get-LogSummary cmdlet retrieves summary counts of operations logged within time intervals inside a date range. The returned data indicates the rate at which configuration changes and activities were performed out within a time period.

Related topics

Get-LogHighLevelOperation

Get-LogLowLevelOperation

Parameters

-StartDateRange<DateTime>

Specifies the start of the summary period date range

Required?

false

Default Value 1900-01-01 00:00:00

Accept Pipeline Input?

false

-EndDateRange<DateTime>

Specifies the end of the summary period date range.

Required?

Default Value

Accept Pipeline Input?

-IntervalSeconds<Int64>

Specifies the size, in seconds, of each time interval required within the summary date range. If this is not specified, is null, zero or exceeds the specified date range, it defaults to the total number of seconds between EndDateRange and StartDateRange.

Required?

false

Default Value

Accept Pipeline Input?

Total number of seconds in the EndDateRange and StartDateRange time span.

false

-GetLowLevelOperations<SwitchParameter> false

DateTime.UtcNow

false https://docs.citrix.com

© 1999-2017 Citrix Systems, Inc. All rights reserved.

p.2128

Specifies if the cmdlet should return low level operation summary counts.

Required?

false

Default Value $false - high level operations counts are returned.

Accept Pipeline Input?

false

-IncludeIncomplete<SwitchParameter>

Specifies if incomplete operations should be included in the returned summary counts.

Required?

false

Default Value $false - incomplete operations are excluded.

Accept Pipeline Input?

false

-OperationType<OperationType>

Specifies the type of logged operations to include. Values can be 'AdminActivity' or 'ConfigurationChange'

Required?

Default Value

Accept Pipeline Input?

false false

-AdminAddress<String>

Specifies the address of a XenDesktop controller the PowerShell snap-in will connect to. You can provide this as a host name or an IP address.

Required?

false

Default Value

Accept Pipeline Input?

Localhost. Once a value is provided by any cmdlet, this value becomes the default.

false

Return Values

System.Collections.Generic.Dictionary<string, int>

The summary data is returned as a collection of dictionary items. The 'Key' value of each dictionary item specifies the start of the time interval within the overall summary date range. The 'Value' data in each dictionary item contains the count of operations which were started within that time interval.

Notes

If the specified summary date range and interval period will result in more than 50,000 intervals being returned Get-LogSummary will generate an error and abort the operation.

Examples

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

C:\PS> $logSummary = Get-LogSummary https://docs.citrix.com

© 1999-2017 Citrix Systems, Inc. All rights reserved.

p.2129

Get a summary of all completed high level operations. The returned log summary collection will contain a single item for the time period spanning the entire [1900-01-01 00:00:00]-[UtcNow] date range. e.g.

Key ==> Value

01/01/1900 00:00:00 ==> 41

-------------------------- EXAMPLE 2 --------------------------

C:\PS> $daily = 60*60*24

C:\PS> [DateTime]$startRange = "2013-02-01 14:50:39"

C:\PS> [DateTime]$endRange = $startRange.AddDays(14)

C:\PS> Get-LogSummary -StartDateRange $startRange -EndDateRange $endRange -intervalSeconds $daily

Gets a summarised count of completed high level operations logged over two weeks, at daily intervals. The returned log summary collection will contain multiple items; one for each day in the summary date range. - e.g.

Key ==> Value

01/02/2013 14:50:39 ==> 0

02/02/2013 14:50:39 ==> 4

03/02/2013 14:50:39 ==> 21

04/02/2013 14:50:39 ==> 0

05/02/2013 14:50:39 ==> 0

06/02/2013 14:50:39 ==> 0

07/02/2013 14:50:39 ==> 5

08/02/2013 14:50:39 ==> 0

09/02/2013 14:50:39 ==> 0

10/02/2013 14:50:39 ==> 0

11/02/2013 14:50:39 ==> 0

12/02/2013 14:50:39 ==> 7

13/02/2013 14:50:39 ==> 0

14/02/2013 14:50:39 ==> 0

15/02/2013 14:50:39 ==> 12

-------------------------- EXAMPLE 3 --------------------------

C:\PS> $hourly = 60*60

C:\PS> [DateTime]$startRange = "2013-02-03 00:00:00"

C:\PS> [DateTime]$endRange = "2013-02-03 23:59:59"

C:\PS> Get-LogSummary -StartDateRange $startRange -EndDateRange $endRange -intervalSeconds $hourly -GetLowLevelOperations

Gets a summarised count of completed low level operations logged during a day, at hourly intervals. The returned log summary collection will contain multiple items; one for each hour in the summary date range - e.g.

Key ==> Value

04/03/2013 00:00:00 ==> 12

04/03/2013 01:00:00 ==> 10

.

.

04/03/2013 02:00:00 ==> 5 https://docs.citrix.com

© 1999-2017 Citrix Systems, Inc. All rights reserved.

p.2130

.

04/03/2013 21:00:00 ==> 26

04/03/2013 22:00:00 ==> 0

04/03/2013 23:00:00 ==> 9 https://docs.citrix.com

© 1999-2017 Citrix Systems, Inc. All rights reserved.

p.2131