Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Get-JS7Workflow [[-WorkflowPath] <String>] [[-WorkflowVersionId] <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.
One of the parameters -Folder, -WorkflowPath or -RegularExpression has to be specified.

Required?false
Position?1
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

-WorkflowVersionId <String>
Deployed workflows can be are assigned a version identifier. This parameters parameter allows to select
workflows that are selection of
a workflow that is assigned the specified version identifier.

Required?false
Position?2
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

-Folder <String>
Optionally specifies the folder for which workflows should be returned.
One of the parameters -Folder, -WorkflowPath or -RegularExpression has to be specified.

Required?false
Position?3
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 valueFalse
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 valueFalse
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 valueFalse
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 valueFalse
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 valueFalse
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 valueFalse
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 valueFalse
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. One of the parameters -Folder, -WorkflowPath or -RegularExpression has to be specified.

Required?false
Position?46
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

PS > $workflows = Get-JS7Workflow -Folder /some_folder -Recursive

Returns all workflows that are configured available with the specified 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.