The Robust Adaptive Dynamic (RAD) PowerShell Cmdlets include a robust error handling mechanism to enhance the reliability and adaptability of your PowerShell scripts. Error handling is a crucial aspect of script development, ensuring graceful response to unexpected situations and effective troubleshooting.
- Retrieve detailed error information for comprehensive troubleshooting.
- Consistently format error messages to improve readability and maintainability.
- Imports a dictionary of errors from a yaml file.
- List all loaded and available error messages by error code.
- Execute a command and terminate the script gracefully upon command failure.
- Add additional error messages or overwrite existing error messages.
- Check if the logger is enabled before logging messages, ensuring efficient resource usage.
- Display messages of various types to keep users informed about script progress and issues. If logger is enabled it uses PoshLog, otherwise gracefully fallback to
Write-Host.
For in-depth explanations, examples, and usage scenarios, refer to the comprehensive polyglot documentation here. The polyglot documentation provides detailed insights into leveraging error handling capabilities and maximizing the potential of RAD PowerShell Cmdlets in various programming languages.
Note: This README serves as a quick overview. Detailed documentation can be found in the polyglot guide linked above.
In order to run the Polyglot documentation, you need to install the following dependencies:
This repo is set up with a devcontainer that will automatically install the dependencies and is ready to be used. You can open it with Visual Studio Code or GitHub Codespaces.