Throw statement in PowerShell - Step-by-Step Execution

Concept Flow - Throw statement

Start script

↓

Check for error condition

Yes↓

Throw error with message

↓

Script stops and shows error

No↓

Continue script normally

↓

End script

The script checks for an error condition. If true, it throws an error and stops execution. Otherwise, it continues normally.

Execution Sample

PowerShell

if ($age -lt 18) {
    throw "Age must be 18 or older"
}
Write-Output "Access granted"

This script throws an error if age is less than 18; otherwise, it prints 'Access granted'.

Execution Table

Step	Variable $age	Condition ($age -lt 18)	Action	Output/Error
1	16	True	Throw error	Age must be 18 or older
2	20	False	Write output	Access granted

💡 Execution stops immediately when throw is executed at step 1.

Variable Tracker

Variable	Start	After Step 1	After Step 2
$age	16 or 20	16 or 20	16 or 20

Key Moments - 2 Insights

Why does the script stop after the throw statement?

Because throw immediately stops script execution and shows the error message, as seen in execution_table step 1.

What happens if the condition is false?

The script skips the throw and continues to write output, shown in execution_table step 2.

Visual Quiz - 3 Questions

Look at the execution table, what is the output when $age is 16?

A No output

B Age must be 18 or older

C Access granted

D Script continues silently

💡 Hint

Check execution_table row 1 where $age=16 and condition is True.

At which step does the script stop due to throw?

A Step 1

B Step 2

C After Step 2

D Never stops

💡 Hint

See exit_note and execution_table step 1 action.

If $age is 20, what will the script output?

A Age must be 18 or older

B Error thrown

C Access granted

D No output

💡 Hint

Look at execution_table step 2 where condition is False.

Concept Snapshot

Throw statement in PowerShell:
- Use 'throw "message"' to stop script with error.
- Throws immediately stop execution.
- Use inside conditions to catch invalid states.
- If condition false, script continues normally.
- Error message helps identify problem.

Full Transcript

The throw statement in PowerShell is used to stop script execution immediately when an error condition occurs. In the example, if the variable $age is less than 18, the script throws an error with the message 'Age must be 18 or older' and stops. If $age is 20, the condition is false, so the script continues and outputs 'Access granted'. The execution table shows these two cases step by step. Throw helps catch problems early and prevents further script running when something is wrong.

Practice

1. What does the throw statement do in PowerShell?

easy

A. It stops the script and shows an error message.

B. It continues the script without any interruption.

C. It prints a warning but does not stop the script.

D. It pauses the script and waits for user input.

Solution

1. Step 1: Understand the purpose of throw

   The throw statement is used to stop script execution immediately and display an error message.

2. Step 2: Compare with other options

   Options B, C, and D describe behaviors that do not match throw. Only It stops the script and shows an error message. correctly describes stopping the script with an error.

3. Final Answer:

   It stops the script and shows an error message. -> Option A

4. Quick Check:

   throw stops script = A [OK]

Hint: Remember: throw always stops script with error [OK]

Common Mistakes:

• Thinking throw only shows a warning
• Confusing throw with Write-Host or Write-Warning
• Assuming throw pauses for input

2. Which of the following is the correct syntax to throw an error with the message "File not found" in PowerShell?

easy

A. throw -Message "File not found"

B. throw 'File not found'

C. throw File not found

D. throw(File not found)

Solution

1. Step 1: Check correct syntax for throw message

   PowerShell requires the error message to be a string, enclosed in quotes. Both single and double quotes work, but single quotes are common.

2. Step 2: Analyze each option

   throw -Message "File not found" is invalid (throw has no -Message parameter). throw(File not found) uses parentheses incorrectly. throw File not found misses quotes, causing syntax error. throw 'File not found' uses correct syntax.

3. Final Answer:

   throw 'File not found' -> Option B

4. Quick Check:

   throw 'message' syntax = D [OK]

Hint: Use quotes around error message with throw [OK]

Common Mistakes:

• Omitting quotes around the error message
• Using parentheses incorrectly with throw
• Confusing throw syntax with function call

3. What will be the output of this PowerShell script?

try {
  throw 'Error occurred'
  Write-Output 'This will not run'
} catch {
  Write-Output "Caught: $_"
}

medium

A. This will not run

B. Error occurred

C. No output

D. Caught: Error occurred

Solution

1. Step 1: Understand throw inside try block

   The throw stops execution inside try and passes control to catch with the error message.

2. Step 2: Check catch block output

   The catch block outputs "Caught: $_" where $_ contains the error message 'Error occurred'. So output is "Caught: Error occurred".

3. Final Answer:

   Caught: Error occurred -> Option D

4. Quick Check:

   throw in try triggers catch output = C [OK]

Hint: throw inside try triggers catch block output [OK]

Common Mistakes:

• Expecting code after throw to run
• Ignoring catch block output
• Confusing error message with direct output

4. Identify the error in this PowerShell script:

try {
  throw "Missing file"
} catch {
  Write-Output "Error: $error"
}

medium

A. The try block should not contain throw.

B. The throw statement is missing parentheses.

C. The catch block uses $error instead of $_ to get the error message.

D. Write-Output cannot be used inside catch.

Solution

1. Step 1: Review error variable usage in catch

   Inside catch, the automatic variable $_ holds the current error. $error is an array of all errors, not the current one.

2. Step 2: Identify correct variable for error message

   Using $error will output the entire error list, not the specific message. $_ is correct to get the thrown error message.

3. Final Answer:

   The catch block uses $error instead of $_ to get the error message. -> Option C

4. Quick Check:

   Use $_ in catch for error message = A [OK]

Hint: Use $_ in catch, not $error, for current error message [OK]

Common Mistakes:

• Using $error instead of $_ in catch
• Thinking throw needs parentheses
• Believing throw can't be inside try

5. You want to stop a script if a variable $filePath is empty or null, showing the message "File path is required". Which code snippet correctly uses throw to do this?

hard

A. if (-not $filePath) { throw 'File path is required' }

B. if ($filePath -eq $null) throw File path is required

C. throw 'File path is required' if ($filePath -eq '')

D. if ($filePath) { throw 'File path is required' }

Solution

1. Step 1: Check condition for empty or null variable

   Using -not $filePath correctly checks if $filePath is null, empty, or false.

2. Step 2: Verify throw syntax and condition placement

   if (-not $filePath) { throw 'File path is required' } uses correct if statement and throw with quoted message. if ($filePath -eq $null) throw File path is required misses quotes and may cause syntax error. throw 'File path is required' if ($filePath -eq '') has wrong syntax order. if ($filePath) { throw 'File path is required' } throws when $filePath exists, which is wrong.

3. Final Answer:

   if (-not $filePath) { throw 'File path is required' } -> Option A

4. Quick Check:

   Use if (-not var) { throw 'msg' } = B [OK]

Hint: Use if (-not $var) { throw 'msg' } to check empty/null [OK]

Common Mistakes:

• Forgetting quotes around error message
• Using throw before if condition
• Throwing error when variable is set