Custom error messages in PowerShell

Introduction

Custom error messages help you understand what went wrong in your script in a clear and friendly way.

When you want to tell the user exactly why a command failed.

When you want to stop the script and explain the problem clearly.

When you want to check if a file exists and show a message if it doesn't.

When you want to handle mistakes in user input with a helpful message.

When you want to log errors with specific details for later review.

Syntax

PowerShell

try {
    # Code that might cause an error
} catch {
    Write-Error "Custom error message here"
}

The try block contains code that might fail.

The catch block runs if there is an error and shows your custom message.

Examples

This tries to get a file. If it doesn't exist, it shows a custom message.

PowerShell

try {
    Get-Item 'C:\nonexistentfile.txt'
} catch {
    Write-Error "File not found. Please check the path."
}

This tries to convert text to a number. If it fails, it shows a clear message.

PowerShell

try {
    $number = [int]"abc"
} catch {
    Write-Error "Invalid number format. Please enter digits only."
}

Sample Program

This script tries to divide 10 by zero, which causes an error. The catch block shows a friendly message. Then the script continues.

PowerShell

try {
    # Try to divide by zero to cause an error
    $result = 10 / 0
} catch {
    Write-Error "Oops! Division by zero is not allowed."
}

Write-Output "Script continues after handling the error."

Important Notes

Use Write-Error to show error messages in red text.

You can also use throw to stop the script with a custom error.

Always test your error messages to make sure they are clear and helpful.

Summary

Custom error messages make your scripts easier to understand.

Use try and catch blocks to handle errors gracefully.

Write clear and friendly messages to help users fix problems.