...
Get-JobSchedulerJob
SYNOPSIS
Returns job information a number of jobs from the JobScheduler Master.
SYNTAX
Get-JobSchedulerJob [[-JobDirectory] <String>] [[-JobChain] <String>] [[-DirectoryJob] <String>] [-Recursive] [-Compact] [-WithHistory] [-WithLog] [[-MaxLastHistoryItems] <Int32>] [-IsOrderJob] [-IsStandaloneJob-NoSubfolders] [-Pending] [-Stopped] [-WaitingForResourceRunningTasks] [-RunningEnqueuedTasks] [-EnqueuedNoCache] [<CommonParameters>]
DESCRIPTION
Jobs are returned retrieved from a JobScheduler Master.
Jobs can be selected either by name, folder, status etc. including sub-folders.
The job information retured includes volatile status information and the permanent configuration.
The cmdlet optionally returns the task history and logs of recent task executionsthe folder of the job location including subfolders or by an individual job.
Resulting jobs can be forwarded to other cmdlets for pipelined bulk operations.
PARAMETERS
...
Directory
-Job Directory <String>
Optionally specifies the path and name of a job.
If the name of a job is specified then the -Directory parameter is used to determine the folder.
Otherwise the -Job parameter is assumed to include the full path and name of the jobfolder for which jobs should be returned. The directory is determined
from the root folder, i.e. the "live" directory.
One of the parameters -Directory, -JobChain or -Job has to be specified.
Required? | false |
Position? | 1 |
Default value | / |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
...
Required? | false |
Position? | 2 |
Default value | |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
...
Job
-Directory Job <String>
Optionally specifies the folder for which jobs should be returned. The directory is determined
from the root folder, i.e. the "live" directory.
Required? | false |
Position? | 3 |
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 -Directory parameter.
By default no sub-folders will be looked up for jobs.
Required? | false |
Position? | named |
Default value | False |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
Compact
-Compact <SwitchParameter>
Specifies that a smaller subset of information is provided, e.g. no task queues for jobs.
By default all information available for jobs is returned.
path and name of a job.
If the name of a job is specified then the -Directory parameter is used to determine the folder.
Otherwise the -Job parameter is assumed to include the full path and name of the job.
One of the parameters -Directory, -JobChain or -Job has to be specified.
Required? | false |
Position? | named3 |
Default valueFalse | |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
...
WithLog
-WithHistory WithLog <SwitchParameter>
Specifies the task history log to be returned.
The parameter -MaxLastHstoryitems specifies the number of history items returned.
This operation is time-consuming and should be restricted to selecting individual jobs.
Required? | false |
Position? | named |
Default value | False |
Accept pipeline input? | true (ByPropertyName)false |
Accept wildcard characters? | false |
...
NoSubfolders
-WithLog NoSubfolders <SwitchParameter>
Specifies the task log to be returned. This implicitely includes to return the task history.
For each history item - up to the number speicifed with the -MaxLastHistoryItems parameter -
the task log is returned.
This operation can be time-consumingthat no subfolders should be looked up. By default any subfolders will be searched for jobs.
Required? | false |
Position? | named |
Default value | False |
Accept pipeline input? | true (ByPropertyName)false |
Accept wildcard characters? | false |
...
Stopped
-MaxLastHistoryItems <Int32>
Specifies the number of the most recent history items of task executions to be returned.
Default: 1
Required? | false |
Position? | 4 |
Default value | 1 |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
IsOrderJob
-IsOrderJob <SwitchParameter>
Specifies to exclusively return jobs that can be used in job chainsStopped <SwitchParameter>
Specifies that only stopped jobs should be returned.
This parameter cannot be combined with -JobChain, -RunningTasks, -EnqueuedTasks.
Required? | false |
Position? | named |
Default value | False |
Accept pipeline input? | true (ByPropertyName)false |
Accept wildcard characters? | false |
...
RunningTasks
-IsStandaloneJob RunningTasks <SwitchParameter>
Specifies to exclucively return jobs that can be used standalone (without job chains).
Required? | false |
Position? | named |
Default value | False |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
Pending
-Pending <SwitchParameter>
Returns jobs in a pending state, i.e. jobs that are ready to be executed at a later date.
Required? | false |
Position? | named |
Default value | False |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
Stopped
-Stopped <SwitchParameter>
Returns stopped jobs. Such jobs would not restart automaticallythat only jobs with running tasks should be returned.
This parameter cannot be combined with -Stopped and -EnqueuedTasks.
Required? | false |
Position? | named |
Default value | False |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
WaitingForResource
-WaitingForResource <SwitchParameter>
Required? | false |
Position? | named |
Default value | False |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
...
EnqueuedTasks
-Running EnqueuedTasks <SwitchParameter>
Specifies that only jobs with running enqueued tasks should be returned.
This parameter cannot be combined with -Stopped and -RunningTasks.
Required? | false |
Position? | named |
Default value | False |
Accept pipeline input? | true (ByPropertyName)false |
Accept wildcard characters? | false |
...
NoCache
-Enqueued NoCache <SwitchParameter>
Specifies that jobs with enqueued tasks should be returnedthat the cache for JobScheduler objects is ignored.
This results in the fact that for each Get-JobScheduler* cmdlet execution the response is
retrieved directly from the JobScheduler Master and is not resolved from the cache.
Required? | false |
Position? | named |
Default value | False |
Accept pipeline input? | true (ByPropertyName)false |
Accept wildcard characters? | false |
...
PS > $jobs = Get-JobSchedulerJob
Returns all jobs from all directories recursively.
-------------------------- EXAMPLE 2 --------------------------
PS > $jobs = Get-JobSchedulerJob -Directory / test-NoSubfolders
Returns all jobs that are configured with the root folder ("testlive" directory) without consideration of sub-folderssubfolders.
-------------------------- EXAMPLE 3 --------------------------
PS > $jobs = Get-JobSchedulerJob -Directory /test -Recursive
Returns all jobs that are configured with the folder "test" include jobs from any sub-folders.
-------------------- ------ EXAMPLE 4 --------------------------
PS > $jobs = Get-JobSchedulerJob -JobChain /test/globals/job_chain1
Returns the jobs that are associated with the job chain " job_chain1 " from the folder "/test/globals".
-------------------------- EXAMPLE 5 4 --------------------------
...
Returns the job "job1" from the folder "/test/globals".
-------------------------- EXAMPLE 6 --------------------------
PS > $jobs = Get-JobSchedulerJob -Stopped
Returns any stopped jobs.
-------------------------- EXAMPLE 7 --------------------------
PS > $jobs = Get-JobSchedulerJob -Directory /test -Pending -Running
Returns any pending or running jobs from the "/test" directory.