Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

-OrderId <String>
Optionally specifies the path and name ID of an order for which daily plan items should be returned.
If the name of an order ID is specified then the -Directory parameter is used to determine the folder.
Otherwise the -OrderId parameter is assumed to include the full path and name ID of the order.

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

...

JobStream

-JobStream <String>
Optionally specifies the name of a job stream for which daily plan items should be returned.
Job streams are unique across folders and are specified by name.
Therefore the -Directory parameter is ignored if this parameter is used.

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

...

-RegEx <String>
Specifies a regular expression that filters the paths items to be returned.
This applies to jobs, job chains, orders and job streams that are filtered by path including their name.

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

...

-RelativeDateFrom <String>
Specifies a relative date starting from which history daily plan items 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.
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.

...

-RelativeDateTo <String>
Specifies a relative date until which history daily plan items 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.
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 -DateTo DateFrom parameter.

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

...

-Timezone <TimeZoneInfo>
Specifies the timezone time zone to which dates should be converted in the daily plan information.
A timezone time zone 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 <SwitchParameter>
Specifies that daily plan items are returned that did start that are late or that started later than expected.

Required?false
Position?named
Default valueFalse
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

-Successful <SwitchParameter>
Specifies that daily plan items are returned that did complete completed successfully.

Required?false
Position?named
Default valueFalse
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

-Failed <SwitchParameter>
Specifies that daily plan items are returned that did complete completed with errors.

Required?false
Position?named
Default valueFalse
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

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

...

Required?false
Position?named
Default valueFalse
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

about_jobschedulerJobScheduler

EXAMPLES

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

...

Returns the daily plan items for the next 3 days until modnightmidnight.

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

PS > $items = Get-JobSchedulerDailyPlan -RelativeDateFrom -7d

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

-------------------------- EXAMPLE 8 --------------------------

PS > $items = Get-JobSchedulerDailyPlan -RelativeDateFrom -7d+01:00

Returns the daily plan for the last seven days. The daily plan is reported starting from 1 hour after midnight UTC.

-------------------------- EXAMPLE 9 --------------------------

PS > $items = Get-JobSchedulerDailyPlan -RelativeDateFrom -7d+TZ

Returns the daily plan for the last seven days. The daily plan is reported starting from midnight in the same timezone that is used with the -Timezone parameter.

-------------------------- EXAMPLE 10 --------------------------

PS > $items = Get-JobSchedulerDailyPlan -RelativeDateFrom -1w

Returns the daily plan for the last week.

-------------------------- EXAMPLE 11 --------------------------

PS > $items = Get-JobSchedulerDailyPlan -Failed -Late

Returns today's daily plan items for jobs that failed or started later than expectedare late, i.e. that did not start at the expected point in time.

-------------------------- EXAMPLE 8 12 --------------------------

PS > $items = Get-JobSchedulerDailyPlan -JobChain /holidays/some_job_chainsos/dailyplan/CreateDailyPlan

Returns the daily plan items for any orders of the given job chain.

-------------------------- EXAMPLE 9 13 --------------------------

...