KNOWLEDGE BASE ARTICLE

Configuring Powershell Script Execution in Umango

Configuring and running Powershell scripts in Umango can be a little more challenging if you require multiple parameters and are not able to simply call the script directly. This article walks you through the steps required to execute a custom PowerShell script as part of the export process in Umango. In the example, the script is designed to rename the file extension from .tif to .tiff.

Step 1: Prepare the Script

  1. Write your script file eg. RenameExt.ps1.
  2. Copy the script to the following directory:
     C:\Program Files\Umango\25\scripts
    If the scripts folder does not exist, create it.
  3. Right-click the file, choose Properties, and check for a security warning at the bottom. If present, click Unblock and then click OK.

Step 2: Allow PowerShell Script Execution

Ensure that the user account running the Umango Windows Service has permission to run PowerShell scripts:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Or define it at the service level via Group Policy or execution policy for the user profile associated with the service.

Step 3: Configure the Export Routine (assuming an export script)

Routine Configuration
  1. In Umango, go to Destinations > Routines.
  2. Under Run after each document, specify:
    C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe
  3. Click Select Arguments and configure the parameters as follows:

Script Arguments

Script Arguments

Note: Change the arguments to match those required by your script.

Step 4: Run a Test

Save your job configuration and run a sample document through Umango. Check that the script executes and successfully completes the task required.


If you encounter issues, verify script execution permissions and check the Windows Event Viewer or Umango history logs for more details.

Link to this article https://umango.com/KB?article=149