...
Name
Get-JobSchedulerJobHistory
SYNOPSIS
Returns a number of JobScheduler history entries items for jobs.
SYNTAX
Get-JobSchedulerJobHistory [[-DirectoryJob] <String>] [[-JobChain] <String>] [[-Job <String> Directory] <String>] [-Recursive] [-MaxHistoryEntries <Int32>Compact] [-WithLog] [[-MaxLastHistoryItems] <Int32>] [<CommonParameters>]
DESCRIPTION
Job history entries This cmdlet is deprecated as it is an alias for the Get-JobSchedulerJob cmdlet that
offers the same functionality when used with the -WithHistory switch. Therefore the
same functionality applies to both cmdlets.
Job history items are returned independently from the fact that the job is present in the JobScheduler Master.
Jobs are selected from a JobScheduler Master
* by the job chain that jobs are
...
used with
* by an individual job
...
* by any jobs from a directory and optionally any sub-folders
PARAMETERS
...
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 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 job.
| Required? | false |
| Position? | 1 |
| Default value | |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |
JobChain
-JobChain <String>
Optionally specifies the path and name of a job chain that includes jobs.
If the name of a job chain is specified then the -Directory parameter is used to determine the folder.
Otherwise the -JobChain parameter is assumed to include the full path and name of the job chain.
| Required? | false |
| Position? | 2 |
| Default value | |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |
...
Directory
-Job Directory <String>
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 job.Required? true
Position? 3
Default value 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 sub-folders should be looked up if the -Directory parameter is used and no job or job chain is specified.
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |
...
Compact
-MaxHistoryEntries <Int32>
Specifies the number of entries that are returned from the history. Entries are provided
in descending order starting with the latest history entry.
Default: 1
...
Compact <SwitchParameter>
Specifies a more compact response with fewer job history attributes.
| Required? | false |
| Position? |
...
| named | |
| Default value | False |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |
WithLog
-WithLog <SwitchParameter>
Specifies the task log to be 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) |
| Accept wildcard characters? | false |
MaxLastHistoryItems
-MaxLastHistoryItems <Int32>
Specifies the number of items that are returned from the history. Items are provided
in descending order starting with the latest history item.
Default: 1
| Required? | false |
| Position? | 4 |
| Default value | 1 |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |
RELATED LINKS
EXAMPLES
-------------------------- EXAMPLE 1 --------------------------
C:\PS>$history PS > $history = Get-JobSchedulerJobHistory -JobChain /test/globals/job_chain1 -Job /test/globals/job1
Returns the latest job history entry item for all jobs used with the specified job that is associated with job chain "job_chain1" from the fold
er "/test/globals" folder.
-------------------------- EXAMPLE 2 --------------------------
C:\PS>$history PS > $history = Get-JobSchedulerJobHistory -JobChain /test/globals/job_chain1 -Job /test/globals/job1 -MaxHistoryEntries 5
Returns the latest 5 job history entries for job "job1item for the specified job that is associated with job chain "job_chain1" from the folder "/test/globals" and includes the log output.
-------------------------- EXAMPLE 3 --------------------------
C:\PS>$history PS > $history = Get-JobSchedulerJobHistory -Job /test/globals/job1 -MaxHistoryEntries WithLog -WithLogMaxLastHistoryItems 5
Returns the latest 5 job history entries items for job "job1" from the folder "/test/globals" and includes the log output.