Page History
Name
Get-JS7AuditLog
SYNOPSIS
Returns the Audit Log entries
SYNTAX
Get-JS7AuditLog [[-OrderId] <String>] [[-Job] <String>] [[-WorkflowPath] <String>] [[-CalendarPath] <String>] [[-Folder] <String>] [-Recursive] [[-RegularExpression] <String>] [[-DateFrom] <DateTime>] [[-DateTo] <DateTime>] [[-RelativeDateFrom] <String>] [[-RelativeDateTo] <String>] [[-Timezone] <TimeZoneInfo>] [[-Account] <String>] [[-TicketLink] <String>] [[-Limit] <Int32>] [<CommonParameters>]
DESCRIPTION
Audit log information is returned from a JOC Cockpit instance.
Audit log entries can be selected by workflow path, order ID, folder etc.
The audit log information returned includes point in time, request, object etc.
PARAMETERS
OrderId
-OrderId <String>
Optionally specifies the identifier of an order for which audit log entries should be returned.
Required? | false |
Position? | 1 |
Default value | |
Accept pipeline input? | true (ByValue, ByPropertyName) |
Accept wildcard characters? | false |
Job
-Job <String>
Optionally specifies the name of a job for which audit log entries should be returned.
Required? | false |
Position? | 2 |
Default value | |
Accept pipeline input? | true (ByValue, ByPropertyName) |
Accept wildcard characters? | false |
WorkflowPath
-WorkflowPath <String>
Optionally specifies the path and name of a workflow for which audit log information should be returned.
Required? | false |
Position? | 3 |
Default value | |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
CalendarPath
-CalendarPath <String>
Required? | false |
Position? | 4 |
Default value | |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
Folder
-Folder <String>
Optionally specifies the folder that includes workflows for which audit log entries should be returned.
Required? | false |
Position? | 5 |
Default value | / |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
Recursive
-Recursive <SwitchParameter>
Specifies that any sub-folders should be looked up when used with the -Folder parameter.
By default no sub-folders will be looked up for workflow paths.
Required? | false |
Position? | named |
Default value | False |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
RegularExpression
-RegularExpression <String>
Specifies a regular expression that filters audit log entries to be returned.
The regular expression is applied to the order ID or job.
Required? | false |
Position? | 6 |
Default value | |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
DateFrom
-DateFrom <DateTime>
Specifies the date starting from which audit log entries should be returned.
Consider that a UTC date has to be provided.
Default: Begin of the current day as a UTC date
Required? | false |
Position? | 7 |
Default value | (Get-Date -Hour 0 -Minute 0 -Second 0).ToUniversalTime() |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
DateTo
-DateTo <DateTime>
Specifies the date until which audit log entries should be returned.
Consider that a UTC date has to be provided.
Default: End of the current day as a UTC date
Required? | false |
Position? | 8 |
Default value | (Get-Date -Hour 0 -Minute 0 -Second 0).AddDays(1).ToUniversalTime() |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
RelativeDateFrom
-RelativeDateFrom <String>
Specifies a relative date starting from which audit log entries should be returned, e.g.
* -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, that 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? | 9 |
Default value | |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
RelativeDateTo
-RelativeDateTo <String>
Specifies a relative date until which audit log entries should be returned, e.g.
* -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, that 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? | 10 |
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-JS7OrderHistory -Timezone (Get-Timezone -Id 'GMT Standard Time')
All dates in JobScheduler are UTC and can be converted e.g. to the local time zone like this:
Get-JS7OrderHistory -Timezone (Get-Timezone)
Default: Dates are returned in UTC.
Required? | false |
Position? | 11 |
Default value | (Get-Timezone -Id 'UTC') |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
Account
-Account <String>
Limits results to entries that have been caused by the specified account.
Required? | false |
Position? | 12 |
Default value | |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
TicketLink
-TicketLink <String>
Limits results to entries that inlcude the specified ticket link.
Required? | false |
Position? | 13 |
Default value | |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
Limit
-Limit <Int32>
Specifies the max. number of audit log entries to be returned.
The default value is 10000, for an unlimited number of items the value -1 can be specified.
Required? | false |
Position? | 14 |
Default value | 0 |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
RELATED LINKS
EXAMPLES
-------------------------- EXAMPLE 1 --------------------------
PS > $items = Get-JS7AuditLog
Returns today's audit log entries.
-------------------------- EXAMPLE 2 --------------------------
PS > $items = Get-JS7AuditLog -RegularExpression "sos$'
Returns today's audit log entries for any order IDs, workflow paths or job names end with the string "sos".
-------------------------- EXAMPLE 3 --------------------------
PS > $items = Get-JS7AuditLog -Timezone (Get-Timezone)
Returns today's audit log entries with dates being converted to the local timezone.
-------------------------- EXAMPLE 4 --------------------------
PS > $items = Get-JS7AuditLog -Timezone (Get-Timezone -Id 'GMT Standard Time')
Returns today's audit log entries with dates being converted to the GMT timezone.
-------------------------- EXAMPLE 5 --------------------------
PS > $items = Get-JS7AuditLog -WorkflowPath /some_path/some_workflow
Returns today's audit log entries for a given workflow.
-------------------------- EXAMPLE 6 --------------------------
PS > $items = Get-JS7AuditLog -DateFrom "2020-08-11 14:00:00Z"
Returns the audit log entries that started after the specified UTC date and time.
-------------------------- EXAMPLE 7 --------------------------
PS > $items = Get-JS7AuditLog -DateFrom (Get-Date -Hour 0 -Minute 0 -Second 0).AddDays(-7).ToUniversalTime()
Returns the audit log entries for the last seven days.
-------------------------- EXAMPLE 8 --------------------------
PS > $items = Get-JS7AuditLog -RelativeDateFrom -7d
Returns the audit log for the last seven days. The audit log is reported starting from midnight UTC.
-------------------------- EXAMPLE 9 --------------------------
PS > $items = Get-JS7AuditLog -RelativeDateFrom -7d+01:00
Returns the audit log for the last seven days. The audit log is reported starting from 1 hour after midnight UTC.
-------------------------- EXAMPLE 10 --------------------------
PS > $items = Get-JS7AuditLog -RelativeDateFrom -7d+TZ
Returns the audit log for the last seven days. The audit log is reported starting from midnight in the same timezone that is used with the -Timezone parameter.
-------------------------- EXAMPLE 11 --------------------------
PS > $items = Get-JS7AuditLog -RelativeDateFrom -1w
Returns the audit log entries for the last week.