developer.sailpoint.com/docs/tools/sdk/powershell/error-handling.md

id, title, pagination_label, sidebar_label, sidebar_position, sidebar_class_name, keywords, description, slug, tags

id	title	pagination_label	sidebar_label	sidebar_position	sidebar_class_name	keywords	description	slug	tags
powershell-sdk-error-handling	Error handling with the PowerShell SDK	PowerShell SDK	Error Handling	7	powershellsdk	powershell sdk error	Learn how to delete resources using the PowerShell SDK in this guide.	/tools/sdk/powershell/error-handling	SDK

The SDK uses the Invoke-WebRequest cmdlet to handle HTTP requests. Invoke-WebRequest will throw a terminating error for any response that falls out of the range of 2xx. A non-2xx response will immediately halt the program and produce a stack trace.

You can use a try/catch function to intercept any non success response and take actions on the results, such as logging the message or performing additional actions before exiting the program:

# Catch any non 2xx response and log the status code and error message
try {
    Get-Transforms -Filters "id eq"
}
catch {
    Write-Host $_.Exception.Response.StatusCode.value__
    Write-Host $_.ErrorDetails
}

The catch block will handle the error, and the script execution will continue. If you want to stop the scripts execution, include an Exit in the catch block:

This code ensures that the Get-AccessProfiles cmdlet will never be called:

# Catch any non 2xx response and log the status code and error message. Stop the script with the Exit keyword.
try {
    Get-Transforms -Filters "id eq"
}
catch {
    Write-Host $_.Exception.Response.StatusCode.value__
    Write-Host $_.ErrorDetails
    Exit
}

Get-AccessProfiles