{"id":567,"date":"2018-07-23T08:00:06","date_gmt":"2018-07-23T14:00:06","guid":{"rendered":"https:\/\/practicalpowershell.com\/?p=567"},"modified":"2020-03-14T16:25:03","modified_gmt":"2020-03-14T22:25:03","slug":"basic-error-handling","status":"publish","type":"post","link":"https:\/\/practicalpowershell.com\/basic-error-handling\/","title":{"rendered":"Basic Error Handling"},"content":{"rendered":"

\"\"<\/a>Like all programming languages, PowerShell has a form of error handling to help the programmer or scripter, as the case may be. Error handling is meant to help troubleshoot a script or at the very least reveal a problem has occurred and possibly provide an error message. There are many ways to handle errors in PowerShell scripts. We can suppress the error messages, trigger another action with an error message, skip parts of scripts, and more.

\nOne type of error handling is the use of the Try {} Catch {} pair. It can be used to trigger actions if a particular code set fails. The error action can be tailored to the specific needs of the script.

\nExample (1) – Sending Email through Office 365<\/u>

\nSample code no error handling<\/em>
\n[sourcecode language=”powershell”]
\n$To = 'recipient@domain.com'
\n$From = 'sender@domain.com'
\n$Subject = 'Test Email'
\n$SMTPServer = 'smtp.office365.com'
\n$Port = '587'
\nSend-MailMessage -To $To -From $From -Subject $Subject -SMTPServer $SMTPServer -Credential $SMTPCred -Port $Port -UseSsl -ErrorAction STOP
\n[\/sourcecode]
\nIn the above code, if the Send-MailMessage command fails we’ll simply get a bunch of red errors from PowerShell. No option for recourse or notification. In order to handle this type of situation, we use Try {} Catch {} like so:
\n[sourcecode language=”powershell”]
\nTry {
\nSend-MailMessage -To $To -From $From -Subject $Subject -SMTPServer $SMTPServer -Credential $SMTPCred -Port $Port -UseSsl -ErrorAction STOP
\n} Catch [Exception] {
\nWrite-host " "
\nWrite-host "Sending email from $From to $To failed – Try again." -ForegroundColor Red
\nWrite-host " "
\nWrite-host " — Error Message — " -ForegroundColor Yellow
\n$Exception = $_.Exception.GetType().FullName
\n$Message = $_.Exception.Message
\nWrite-host " $Exception" -ForegroundColor Yellow
\nWrite-host " $Message" -ForegroundColor Yellow
\n}
\n[\/sourcecode]
\nA sample error message with the new code:
\n\"\"<\/a>
\nBeyond just displaying simple messages, Try and Catch can be used for other actions:<\/p>\n