Edit

Share via

about_Parallel

  • Article

SHORT DESCRIPTION

Describes the parallel keyword, which runs the activities in a workflow in parallel.

LONG DESCRIPTION

The parallel keyword runs workflow activities in parallel. This keyword is valid only in Windows PowerShell Workflow.

SYNTAX

workflow <Verb-Noun> {
     parallel {
          [<Activity>]
          [<Activity>]
        ...
     }
 }

DETAILED DESCRIPTION

The commands in a parallel script block can run concurrently. The order in which they run is not determined.

For example, the following workflow includes a parallel script block that runs activities that get processes and services on the computer. Because the Get-Process and Get-Service commands are independent of each other, they can run concurrently and in any order.

workflow Test-Workflow {
    parallel {
         Get-Process
         Get-Service
    }
}

Running commands in parallel is very efficient and reduces the time it takes to complete a workflow significantly.

To run selected commands in a parallel script block in sequential order, use the sequence keyword. For more information, see about_Sequence.

To run a script block on items in a collection, use the foreach or foreach -Parallel keywords.

See Also