Page History
...
Returns workflows from the JS7 JOC Cockpit .inventory
SYNTAX
Get-JS7Workflow [[-WorkflowPath] <String>] [[-DirectoryWorkflowVersionId] <String>] [[-Folder] <String>] [-Recursive] [-Suspended] [-Outstanding] [-Synchronized] [-NotSynchronized] [-SkippedInstruction] [-StoppedInstruction] [[-Tag] <String[]>] [[-AgentName] <String[]>] [[-RegularExpression] <String>] [-Compact] [<CommonParameters>]
...
Workflows are returned from JOC Cockpit - independent , independently of their deployment status with specific Controller instances..
Workflows can be selected either by the folder of the workflow location including sub-folders or by an individual the workflow name or path.
Resulting workflows can be forwarded to other cmdlets for pipelined bulk operations.
The following REST Web Service API resources are used:
* /workflows
PARAMETERS
WorkflowPath
-WorkflowPath <String>
Optionally specifies the path and or name of a workflow that should be returned.
If the name of a workflow is specified then the -Directory parameter is used to determine the folder.
Otherwise the -WorkflowPath parameter is assumed to include the full path and name of the workflow.
One of the parameters -Directory or -WorkflowPath has to be specified
Required? | false |
Position? | 1 |
Default value | |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
WorkflowVersionId
-WorkflowVersionId <String>
Deployed workflows are assigned a version identifier. This parameter allows selection of
a workflow that is assigned the specified version identifier.
Required? | false |
Position? | 12 |
Default value | |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
...
Folder
-Directory Folder <String>
Optionally specifies the folder for which workflows should be returned.
One of the parameters -Directory and -WorkflowPath has to be specified.
Required? | false |
Position? | 23 |
Default value | / |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
...
-Recursive <SwitchParameter>
Specifies When used with the -Folder parameter specifies that any sub-folders should be looked up.
By default no sub-folders will be searched for workflows.
Required? | false |
Position? | named |
Default value | False |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
Suspended
-Suspended <SwitchParameter>
Filters workflows to be returned that are in suspended state. Such workflows are frozen.
Required? | false |
Position? | named |
Default value | False |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
Outstanding
-Outstanding <SwitchParameter>
Filters workflows to be returned that are in outstanding state. Such workflows are not confirmed by Agents to be successfully suspended or resumed.
Required? | false |
Position? | named |
Default value | False |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
Synchronized
-Synchronized <SwitchParameter>
Filters workflows to be returned that are in sync between JOC Cockpit inventory and Controller.
Required? | false |
Position? | named |
Default value | False |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
NotSynchronized
-NotSynchronized <SwitchParameter>
Filters workflows to be returned that are not in sync between JOC Cockpit inventory and Controller.
Required? | false |
Position? | named |
Default value | False |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
SkippedInstruction
-SkippedInstruction <SwitchParameter>
Filters workflows to be returned that include skipped instructions.
Required? | false |
Position? | named |
Default value | False |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
StoppedInstruction
-StoppedInstruction <SwitchParameter>
Filters workflows to be returned that include stopped instructions.
Required? | false |
Position? | named |
Default value | False |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
Tag
-Tag <String[]>
Filters workflows by a list of tags.
If more than one tag is specified then they are separated by comma.
Required? | false |
Position? | 4 |
Default value | |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
AgentName
-AgentName <String[]>
Filters workflows by Agents that are assigned to jobs in the workflow.
If more than one Agent Name is specified, then they are separated by comma.
Required? | false |
Position? | 5 |
Default value | |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
...
-RegularExpression <String>
Limits result results to workflow paths that correspond to the given regular expression.
Required? | false |
Position? | 36 |
Default value | |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
...
Required? | false |
Position? | named |
Default value | False |
Accept pipeline input? | true (ByPropertyName) |
Accept wildcard characters? | false |
RELATED LINKS
EXAMPLES
-------------------------- EXAMPLE 1 --------------------------
...
PS > $workflows = Get-JS7Workflow -Directory Folder /some_path folder -Recursive
Returns all workflows that are configured available with the specified path folder including any sub-folders.
...
PS > $workflows = Get-JS7Workflow -WorkflowPath /test/globals/ workflow1
Returns the workflow "workflow1" independently from the folder "/test/globals"its folder location.
-------------------------- EXAMPLE 4 --------------------------
PS > $workflows = Get-JS7Workflow -Suspended
Returns workflows that are in suspended state.
-------------------------- EXAMPLE 5 --------------------------
PS > $workflows = Get-JS7Workflow -Tag ProductDemo,ScheduledExecution
Returns workflows that hold one or more of the tags specified.
-------------------------- EXAMPLE 6 --------------------------
PS > $workflows = Get-JS7Workflow -AgentName primaryAgent,secondaryAgent
Returns workflows that hold jobs assigned one of the Agents specified.