Pipeline object flow in PowerShell - Step-by-Step Execution

Concept Flow - Pipeline object flow

Start: Command 1 produces objects

↓

Objects flow through pipeline

↓

Command 2 receives objects one by one

↓

Command 2 processes each object

↓

Objects flow to next command or output

↓

End

Objects are passed one by one through the pipeline from one command to the next, allowing each command to process each object in turn.

Execution Sample

PowerShell

1..3 | ForEach-Object { $_ * 2 } | Where-Object { $_ -gt 3 }

This pipeline sends numbers 1 to 3, doubles each, then filters to keep only those greater than 3.

Execution Table

Step	Input Object	ForEach-Object Action	Output Object	Where-Object Condition	Final Output
1	1	1 * 2 = 2	2	2 > 3? False
2	2	2 * 2 = 4	4	4 > 3? True	4
3	3	3 * 2 = 6	6	6 > 3? True	6
4	End of input				Pipeline ends

💡 Input numbers exhausted; pipeline completes after processing all objects.

Variable Tracker

Variable	Start	After 1	After 2	After 3	Final
$_ (ForEach-Object)	N/A	1	2	3	N/A
Output (ForEach-Object)	N/A	2	4	6	N/A
$_ (Where-Object)	N/A	2	4	6	N/A
Final Output	N/A		4	6	N/A

Key Moments - 2 Insights

Why does each command in the pipeline process objects one at a time instead of all at once?

Because PowerShell pipelines pass objects one by one, allowing each command to start processing immediately without waiting for all input, as shown in the execution_table where each input object flows stepwise.

What happens if an object does not meet the condition in Where-Object?

That object is filtered out and does not appear in the final output, as seen in step 1 where '2' fails the condition and is excluded.

Visual Quiz - 3 Questions

Look at the execution table, what is the output of ForEach-Object when the input object is 3?

A 3

B 6

C 9

D 1

💡 Hint

Check the 'ForEach-Object Action' column at step 3 in the execution_table.

At which step does the Where-Object filter out an object?

A Step 1

B Step 2

C Step 3

D No filtering occurs

💡 Hint

Look at the 'Where-Object Condition' column in the execution_table for the step where the condition is false.

If the condition in Where-Object changed to '$_ -gt 1', what would be the final output?

A 4, 6

B 6 only

C 2, 4, 6

D No output

💡 Hint

Consider how the condition affects which objects pass, referencing the variable_tracker and execution_table.

Concept Snapshot

PowerShell pipelines pass objects one at a time from one command to the next.
Each command processes each object before passing it on.
This allows streaming and efficient processing.
Filtering commands like Where-Object remove objects that don't meet conditions.
Use ForEach-Object to transform each object individually.

Full Transcript

In PowerShell, pipelines send objects one by one from one command to the next. For example, the code '1..3 | ForEach-Object { $_ * 2 } | Where-Object { $_ -gt 3 }' sends numbers 1 to 3 through the pipeline. Each number is doubled by ForEach-Object, then filtered by Where-Object to keep only those greater than 3. The execution table shows each step: input object, action, and output. Objects that don't meet the condition are filtered out immediately. This stepwise flow lets commands start processing without waiting for all input. Variables like $_ change with each object processed. Understanding this flow helps write efficient PowerShell scripts.