Updating from older version than 16.1

If you are currently on a powerJobs Processor version that is older than 16.1 use this article.


Compatibility module

Currently powerJobs Processor delivers a compatibility module that ensures that the coolOrange commandlets in your script will still work. This allows you to update without having to change your scripts right away. We recommend to do the manual adjustments though as soon as you are able to.


This is only a time limited solution though. After some time deprecated functions will also disappear from these module.

Manual adjustments

The following version introduced braking changes to powerJobs Processor. If you are updating to one of them or a higher version these updates should be done to your scripts.


Updating to 18.0.11 or newer

Add-Log commandlet has been replaced by Write-Host. Write-Host is a generic Powershell commandlet which doesn't require maintenance on our side. The log window will display messages you write with Write-Host

#Replace cmdlet
Add-Log
Add-Log -Message

#With
Write-Host
Write-Host -Object


Updating to 19.0.7 or newer

The return value of Open-Document, Export-Document, and Close-Document has been changed. Instead of a simple text message it now contains a complex Error object. You have to check how the actual result objects are called in your script before you replace them. In some cases it might be possible to replace .ErrorMessage with .Error.Message, but this approach has the risk of changing to much.

#Replace cmdlet
$openResult = Open-Document ...
$openResult.ErrorMessage

$exportResult = Export-Document ...
$exportResult.ErrorMessage

$closeResult = Close-Document ...
$closeResult.ErrorMessage

#With
$openResult = Open-Document ...
$openResult.Error.Message

$exportResult = Export-Document ...
$exportResult.Error.Message

$closeResult = Close-Document ...
$closeResult.Error.Message