PowerShell CLI 2.0 - Cmdlets - Get-JS7DailyPlanOrder

Name

Get-JS7DailyPlanOrder

SYNOPSIS

Returns the daily plan orders for workflows scheduled for a JS7 Controller

SYNTAX

Get-JS7DailyPlanOrder [[-OrderId] <String>] [[-WorkflowPath] <String>] [[-SchedulePath] <String>] [[-Folder] <String>] [-Recursive] [[-ControllerId] <String>] [[-DateFrom] <DateTime>] [[-DateTo] <DateTime>] [[-RelativeDateFrom] <String>] [[-RelativeDateTo] <String>] [[-Timezone] <TimeZoneInfo>] [-Late] [-Planned] [-Pending] [-InProgress] [-Running] [-Blocked] [-Finished] [-Failed] [<CommonParameters>]

DESCRIPTION

The daily plan orders for workfows are returned.

PARAMETERS

OrderId

-OrderId <String>

WorkflowPath

-WorkflowPath <String>
Optionally specifies the path and name of a workflow for which daily plan orders should be returned.

SchedulePath

-SchedulePath <String>
Optionally specifies the path and name of a schedule for which daily plan orders should be returned.

Folder

-Folder <String>
Optionally specifies the folder with workflows for which daily plan orders should be returned.

Recursive

-Recursive <SwitchParameter>
When used with the -Folder parameter then any sub-folders of the specified folder will be looked up.

ControllerId

-ControllerId <String>

DateFrom

-DateFrom <DateTime>
Optionally specifies the date starting from which daily plan orders should be returned.
Consider that a UTC date has to be provided.

Default: Begin of the current day as a UTC date

DateTo

-DateTo <DateTime>
Optionally specifies the date until which daily plan orders should be returned.
Consider that a UTC date has to be provided.

Default: End of the current day as a UTC date

RelativeDateFrom

-RelativeDateFrom <String>
Specifies a relative date starting from which daily plan orders should be returned, e.g.

* -1d, -2d: one day ago, two days ago
* +1d, +2d: one day later, two days later
* -1w, -2w: one week ago, two weeks ago
* +1w, +2w: one week later, two weeks later
* -1M, -2M: one month ago, two months ago
* +1M, +2M: one month later, two months later
* -1y, -2y: one year ago, two years ago
* +1y, +2y: one year later, two years later

Optionally a time offset can be specified, e.g. -1d+02:00, as otherwise midnight UTC is assumed.

This parameter takes precedence over the -DateFrom parameter.

RelativeDateTo

-RelativeDateTo <String>
Specifies a relative date until which daily plan orders should be returned, e.g.

* -1d, -2d: one day ago, two days ago
* +1d, +2d: one day later, two days later
* -1w, -2w: one week ago, two weeks ago
* +1w, +2w: one week later, two weeks later
* -1M, -2M: one month ago, two months ago
* +1M, +2M: one month later, two months later
* -1y, -2y: one year ago, two years ago
* +1y, +2y: one year later, two years later

Optionally a time offset can be specified, e.g. -1d+02:00, as otherwise midnight UTC is assumed.

This parameter takes precedence over the -DateTo parameter.

Timezone

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

Get-JSDailyPlan -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-JSDailyPlan -Timezone (Get-Timezone)

Default: Dates are returned in UTC.

Late

-Late <SwitchParameter>
Specifies that daily plan orders are returned that are late or that started later than expected.

Planned

-Planned <SwitchParameter>
Specifies that daily plan orders are returned that did not yet start.

Pending

-Pending <SwitchParameter>

InProgress

-InProgress <SwitchParameter>
Specifies that daily plan orders are returned for jobs, orders, job streams that did not yet complete.

Running

-Running <SwitchParameter>

Blocked

-Blocked <SwitchParameter>

Finished

-Finished <SwitchParameter>

Failed

-Failed <SwitchParameter>
Specifies that daily plan orders are returned that completed with errors.

RELATED LINKS

about_JS7

EXAMPLES

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

PS > $orders = Get-JS7DailyPlanOrder

Returns daily plan orders for the current day.

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

PS > $orders = Get-JS7DailyPlanOrder -Timezone (Get-Timezone)

Returns today's daily plan orders for any jobs with dates being converted to the local timezone.

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

PS > $orders = Get-JS7DailyPlanOrder -Timezone (Get-Timezone -Id 'GMT Standard Time')

Returns today's daily plan orders for any jobs with dates being converted to the GMT timezone.

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

PS > $orders = Get-JS7DailyPlanOrder -DateTo (Get-Date).AddDays(3)

Returns the daily plan orders for the next 3 days.

-------------------------- EXAMPLE 5 --------------------------

PS > $orders = Get-JS7DailyPlanOrder -RelativeDateFrom -3d

Returns the daily plan orders for the last three days. The daily plan is reported starting from midnight UTC.

-------------------------- EXAMPLE 6 --------------------------

PS > $orders = Get-JS7DailyPlanOrder -Failed -Late

Returns today's daily plan orders for jobs that failed or are late, i.e. that did not start at the expected point in time.

-------------------------- EXAMPLE 7 --------------------------

PS > $orders = Get-JS7DailyPlanOrder -WorkflowPath /ap/apWorkflow1b

Returns the daily plan orders for the given workflow.