JS7 JobScheduler

Space shortcuts

Page tree

Name

Get-JS7Notification

SYNOPSIS

Returns Notification entries

SYNTAX

Get-JS7Notification [[-ControllerId] <String>] [[-DateFrom] <DateTime>] [[-RelativeDateFrom] <String>] [[-Timezone] <TimeZoneInfo>] [[-Limit] <Int32>] [<CommonParameters>]

DESCRIPTION

Notifications are returned from a JOC Cockpit instance. Notifications can be selected by Controller ID and date.

Note that by default notifications are purged from the database after one day.

The following REST Web Service API resources are used:

* /monitoring/notifications

PARAMETERS

ControllerId

-ControllerId <String>
Optionally specifies the unique identifier of the Controller for which notifications should be returned.

Required?false
Position?1
Default value
Accept pipeline input?true (ByValue, ByPropertyName)
Accept wildcard characters?false

DateFrom

-DateFrom <DateTime>
Specifies the date starting from which notifications should be returned.
Consider that a UTC date has to be provided.

Default: Beginning of the current day as a UTC date

Required?false
Position?2
Default value(Get-Date -Hour 0 -Minute 0 -Second 0).ToUniversalTime()
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

RelativeDateFrom

-RelativeDateFrom <String>
Specifies a relative date starting from which notifications should be returned, for example

* -1s, -2s: one second ago, two seconds ago
* -1m, -2m: one minute ago, two minutes ago
* -1h, -2h: one hour ago, two hours ago
* -1d, -2d: one day ago, two days ago
* -1w, -2w: one week ago, two weeks ago
* -1M, -2M: one month ago, two months ago
* -1y, -2y: one year ago, two years ago

Optionally a time offset can be specified, e.g. -1d+02:00, as otherwise midnight UTC is assumed.
Alternatively a timezone offset can be added, e.g. by using -1d+TZ. This is calculated by the cmdlet
for the timezone that is specified with the -Timezone parameter.

This parameter takes precedence over the -DateFrom parameter.

Required?false
Position?3
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

Timezone

-Timezone <TimeZoneInfo>
Specifies the timezone to which dates should be converted from the history information.
A timezone can e.g. be specified like this:

Get-JS7Notification -Timezone (Get-Timezone -Id 'GMT Standard Time')

All dates in JS7 are UTC and can be converted e.g. to the local time zone like this:

Get-JS7Notification -Timezone (Get-Timezone)

Default: Dates are returned in UTC.

Required?false
Position?4
Default value(Get-Timezone -Id 'UTC')
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

Limit

-Limit <Int32>
Specifies the max. number of notifications to be returned.
The default value is 10000, for an unlimited number of items the value -1 can be specified.

Required?false
Position?5
Default value0
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

about_JS7

EXAMPLES

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

PS > $items = Get-JS7Notification

Returns today's notifications.

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

PS > $items = Get-JS7Notification -DateFrom "2020-08-11 14:00:00Z"

Returns the notifications that were created after the specified UTC date and time.

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

PS > $items = Get-JS7Notification -DateFrom (Get-Date -Hour 0 -Minute 0 -Second 0).AddDays(-7).ToUniversalTime()

Returns the notifications for the last seven days.

-------------------------- EXAMPLE 4 --------------------------

PS > $items = Get-JS7Notification -RelativeDateFrom -1d

Returns notifications for the last day.

  • No labels