Mastering Windows PowerShell Scripting - Third Edition

Error and ErrorVariable

The Error variable is a collection (ArrayList) of handled and unhandled errors raised in the PowerShell session.

Testing the content of error variablesTesting the content of an error variable is not a robust way to test for error conditions. As the variable fills with both handled and unhandled errors, it's indeterminate at best. Error variables continue to have value when debugging less obvious problems with code.

The error collection can be cleared using the Clear method:

$Error.Clear() 

The most recent error is first in the list:

$Error[0] 

Errors will be added to the collection except when ErrorAction is set to Ignore.

The ErrorVariable parameter can be used to name a variable that should be used, as well as ...