...
Name
Get-JobSchedulerOrderHistory
SYNOPSIS
Returns a number of JobScheduler history entries ReturnsJobScheduler history items for orders.
SYNTAX
Get-JobSchedulerOrderHistory [[-DirectoryOrderId] <String>] [[-JobChain] <String>] [[-Order <String>Directory] <String>] [-Recursive] [-MaxHistoryEntries <In
t32>Compact] [-WithLog] [[-MaxLastHistoryItems] <Int32>] [<CommonParameters>]
DESCRIPTION
This cmdlet is deprecated as it is an alias for the Get-JobSchedulerOrder cmdlet that
offers the same functionality when used with the -WithHistory switch. Therefore the
same functionality applies to both cmdlets.
Order history entries items are returned independently from the fact that the order is present in the JobScheduler Master.
This includes temporary ad hoc orders to be returned that are completed and not active
with a Master.
Orders are selected from a JobScheduler Master
* by the job chain that an order is assigned
...
.
* by
...
a specific order.
Resulting orders can be forwarded to other cmdlets for pipelined bulk operations.
PARAMETERS
...
OrderId
-Directory OrderId <String>
Optionally specifies the folder path and name of an order for which orders the history should be returned. The directory is determined
from the root folder, i.e. the "live" directory
If the ID of an order is specified then the -Directory parameter is used to determine the folder.
Otherwise the -OrderId parameter is assumed to include the full path and ID of the order.
| Required? | false |
| Position? | 1 |
| Default value | |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |
JobChain
-JobChain <String>
Specifies the path and name of a job chain for which orders order history items should be returned.
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
-Order Directory <String>
Optionally specifies the path and name of an order that folder for which order history items should be returned. The directory is determined
If the name of an order is specified then the -Directory parameter is used to determine the folder.
Otherwise the -Order parameter is assumed to include the full path and name of the orderfrom the root folder, i.e. the "live" directory.
| Required? | false |
| Position? | 3 |
| Default value | / |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? |
...
| false |
Recursive
-MaxHistoryEntries <Int32>Recursive <SwitchParameter>
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
...
that any sub-folders should be looked up if the -Directory parameter is used.
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |
Compact
-Compact <SwitchParameter>
Specifies that fewer order history attributes will be returned.
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |
WithLog
-WithLog <SwitchParameter>
Specifies the order log to be returned.
This operation is time-consuming and should be restricted to selecting individual orders.
| Required? | false |
| Position? | named |
| Default value | False |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |
MaxLastHistoryItems
-MaxLastHistoryItems <Int32>
Specifies the number of items that should be returned from the history. Items are provided
in descending order starting with the latest history entry.
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-JobSchedulerOrderHistory -JobChain /test/globals/chain1
Returns the latest history entry item for job chain "chain1" from the folder "/test/globals".
-------------------------- EXAMPLE 2 --------------------------
C:\PS>$history PS > $history = Get-JobSchedulerOrderHistory -JobChain /test/globals/chain1 -Order OrderId order1
Returns the latest history entry item for order "order1" from the folder "/test/globals" with the job chain "chain1".
-------------------------- EXAMPLE 3 --------------------------
C:\PS>$history PS > $history = Get-JobSchedulerOrderHistory -JobChain /test/globals/chain1 -MaxHistoryEntries MaxLastHistoryItems 5
Returns the 5 latest history entries items for the specified job chain and includes the log output.
-------------------------- EXAMPLE 4 --------------------------
C:\PS>$history PS > $history = Get-JobSchedulerOrderHistory -JobChain /test/globals/chain1 -WithLog
Returns the 5 latest history entries item for the specified job chain and includes the log output.