A PowerShell terminating error in a post-installation action will not make the K2000 task engine to halt.

If a terminating error occurs in a PowerShell script used in a post-installation action the K2000 task engine will not spot it and will report that the task executed successfully despite the error.

This is normal due to the fact that when such errors happen in the PowerShell engine the return code to the Windows command line (ERRORLEVEL) is always 0.

The K2000 task engine looks for the ERRORLEVEL after executing a command and if it is different from 0 it becomes aware of the error.


To handle this situation and to make aware the task engine that something went wrong in the script it is possible to modify the code using the Exit-PSSession statement (or simply exit that is its alias) to return a not zero exit code.



#Original code
#Even if this code throws intentionally a terminating error the K2000 task engine will not spot it

throw “Personal Error Reason”


This need to be amended in this way:

#This script will handle the terminating
error and set a non zero ERRORLEVEL
#The task engine will spot this error
 try {
    #put your code here
catch {
    #we have an error…
    exit 99

If catch is used without parameters like in this example it will catch all the errors.
To catch and handle different types of error is possible to specify the error to catch immediately after the catch statement.

For more information you can have a look to this excellent article about exception handling in PowerShell:


This post is locked

Don't be a Stranger!

Sign up today to participate, stay informed, earn points and establish a reputation for yourself!

Sign up! or login


This website uses cookies. By continuing to use this site and/or clicking the "Accept" button you are providing consent Quest Software and its affiliates do NOT sell the Personal Data you provide to us either when you register on our websites or when you do business with us. For more information about our Privacy Policy and our data protection efforts, please visit GDPR-HQ