SCOrchDev-Exception

2.2.1

Used for wrapping and handling custom exceptions.

This is designed to make good error handling routines for enterprise automation like what is written for SMA.
Using this library you can make routines (like below) that behave consistantly in PowerShell and PowerShell worfklow.
The module also has functions for throwing meaningful errors to any PowerShell stream o
Used for wrapping and handling custom exceptions.

This is designed to make good error handling routines for enterprise automation like what is written for SMA.
Using this library you can make routines (like below) that behave consistantly in PowerShell and PowerShell worfklow.
The module also has functions for throwing meaningful errors to any PowerShell stream or converting an exception to a
string for usage in other functions.

Example:

Function Test-Throw-Function
{
   try
   {
       Throw-Exception -Type 'CustomTypeA' `
                       -Message 'MessageA' `
                       -Property @{
                           'a' = 'b'
                       }
   }
   catch
   {
       $Exception = $_
       $ExceptionInfo = Get-ExceptionInfo -Exception $Exception
       Switch -CaseSensitive ($ExceptionInfo.Type)
       {
           'CustomTypeA'
           {
               Write-Exception -Exception $Exception -Stream Verbose
               $a = $_
           }
           Default
           {
               Write-Warning -Message 'unhandled' -WarningAction Continue
           }
       }
   }
}


Workflow Test-Throw-Workflow
{
   try
   {
       Throw-Exception -Type 'CustomTypeA' `
                       -Message 'MessageA' `
                       -Property @{
                           'a' = 'b'
                       }
   }
   catch
   {
       $Exception = $_
       $ExceptionInfo = Get-ExceptionInfo -Exception $Exception
       Switch -CaseSensitive ($ExceptionInfo.Type)
       {
           'CustomTypeA'
           {
               Write-Exception -Exception $Exception -Stream Verbose
               $a = $_
           }
           Default
           {
               Write-Warning -Message 'unhandled' -WarningAction Continue
           }
       }
   }
}

Minimum PowerShell version

4.0

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name SCOrchDev-Exception

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deploy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More

Author(s)

Ryan Andorfer

Copyright

(c) SCOrchDev. All rights reserved.

Version History

Version Downloads Last updated
2.2.1 (current version) 8,427 2/23/2016
2.2.0 308 12/21/2015
2.1.7 51 12/17/2015
2.1.1 188 9/16/2015
2.1.0.1 12 9/14/2015
2.1.0.0 30 9/11/2015