NAME
Get-JobSchedulerTask
SYNOPSIS
Retrieves a number of tasks from the JobScheduler Master.
SYNTAX
Get-JobSchedulerTask [-Directory <String>] [-Job <String>] -NoRunningTasks -NoEnqueuedTasks -NoSubfolders [<C
ommonParameters>]
DESCRIPTION
Running and enqueued tasks are retrieved from a JobScheduler Master.
Tasks can be selected either by the folder of the job location including subfolders or by an individual job.
Resulting tasks can be forwarded to the Stop-JobSchedulerTask cmdlet in a bulk operation.
PARAMETERS
Directory
-Directory <String>
Optionally specifies the folder with jobs for which tasks should be returned. The directory is determined
from the root folder, i.e. the "live" directory.
One of the parameters -Directory and -Job has to be specified.
Required? false
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters?
Job
-Job <String>
Optionally specifies the path and name of a job for which tasks should be returned.
If the name of a job is specified then the -Directory parameter is used to determine the job folder.
Otherwise the job is assumed to include the full path and name of the job.
One of the parameters -Directory and -Job has to be specified.
Required? false
Position? 2
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters?
NoRunningTasks
-NoRunningTasks <SwitchParameter>
Specifies that no running tasks should be stopped. By default running tasks will be stopped.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters?
NoEnqueuedTasks
-NoEnqueuedTasks <SwitchParameter>
Specifies that no enqueued tasks should be stopped. By default enqueued tasks will be stopped.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters?
NoSubfolders
-NoSubfolders <SwitchParameter>
Specifies that no subfolders should be looked up for jobs. By default any subfolders will be searched for jobs with
tasks.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters?
RELATED LINKS
about_jobscheduler
EXAMPLES
-------------------------- EXAMPLE 1 --------------------------
C:\PS>$tasks = Get-Task
Returns all running and enqueued tasks for all jobs.
-------------------------- EXAMPLE 2 --------------------------
C:\PS>$tasks = Get-Task -Directory / -NoSubfolders
Returns all running and enqueued tasks that are configured with the root folder ("live" directory)
without consideration of subfolders.
-------------------------- EXAMPLE 3 --------------------------
C:\PS>$tasks = Get-Task -Job /test/globals/job1
Returns all tasks for job "job1" from the folder "/test/globals".