$Error automatic variable in PowerShell - Step-by-Step Execution

Concept Flow - $Error automatic variable

Run Command

↓

Error Occurs?

No→No change to $Error

Yes↓

Add Error to $Error Array

↓

Access $Error for Details

↓

Use or Clear $Error

When a command runs, if an error happens, PowerShell adds it to the $Error list. You can check or clear this list anytime.

Execution Sample

PowerShell

$Error.Clear()
Get-Item nofile.txt
$Error[0]

This clears errors, tries to get a missing file (causing error), then shows the latest error.

Execution Table

Step	Command Run	Error Occurred?	$Error Count	Action	Output
1	$Error.Clear()	No	0	Clear all errors	No output
2	Get-Item nofile.txt	Yes	1	Add error to $Error	Error: Cannot find path 'nofile.txt' because it does not exist.
3	$Error[0]	N/A	1	Show latest error	Error details about missing file

💡 No more commands, $Error holds 1 error from missing file

Variable Tracker

Variable	Start	After Step 1	After Step 2	After Step 3
$Error.Count	Varies (depends on session)	0	1	1
$Error[0]	Most recent error	None	New error from Get-Item	Same error shown

Key Moments - 3 Insights

Why does $Error keep growing with each error?

Because PowerShell adds each new error to the start of the $Error array, growing its size as shown in step 2 of the execution_table.

What does $Error.Clear() do?

It empties the $Error array, removing all previous errors, as seen in step 1 where $Error.Count becomes 0.

How do I see the most recent error?

Use $Error[0] to get the latest error, demonstrated in step 3 of the execution_table.

Visual Quiz - 3 Questions

Look at the execution_table, what is the value of $Error.Count after running Get-Item nofile.txt?

A 0

B 1

C 2

D Error

💡 Hint

Check the $Error Count column at step 2 in the execution_table.

At which step is the $Error array cleared?

A Step 3

B Step 2

C Step 1

D Never

💡 Hint

Look at the Command Run column and the Action at step 1.

If you run another failing command after step 2, how does $Error.Count change?

A It increases by 1

B It decreases

C It stays the same

D It resets to 0

💡 Hint

Recall that each error adds one item to $Error as shown in step 2.

Concept Snapshot

$Error is an automatic array holding recent errors.
New errors are added at the start.
Use $Error[0] for the latest error.
Clear errors with $Error.Clear().
It helps track what went wrong in commands.

Full Transcript

The $Error automatic variable in PowerShell keeps a list of recent errors from commands. When you run a command, if it fails, PowerShell adds that error to the start of the $Error array. You can see how many errors are stored by checking $Error.Count. To clear all errors, use $Error.Clear(). To see the most recent error, use $Error[0]. This helps you understand what problems happened during your script or session.