Skip to main content

Custom Scripts

Overview​

Atria allows for custom PowerShell scripts to be implemented into the platform to trigger based of different events, allowing custom features and functions to be carried out alongside Atria's standard functionality.

This feature is currently implemented for the Workspace Service, allowing the triggering of custom events based on Workspace Item assignment. In future versions, it will be possible to add scripts that can be contextually executed in different parts of Atria.

This guide will walk you through the process of uploading custom PowerShell scripts into Atria so that they can be used within the Workspace service and other areas in future releases.

Refer to the Workspace Automation page to understand how to use scripts within the Workspace Service after you have followed this guide.

Prerequisites​

  • Security Role

By default, only users with the Service Provider Administrator role are able to upload scripts. Other security roles (I.e. Custom Security Roles) can be given the permission Script Management to be able to upload scripts. To learn more about this read here.

  • Multi-Factor Authentication

To be able to upload scripts, users must also be configured to use Atria Multi-Factor Authentication (MFA) for added security. MFA is setup and deployed as a service in Atria, to learn more see the MFA Service Setup.

Process​

  1. Login to Atria with an account that meets the prerequisite requirements.

  2. Navigate to Configuration > System Manager > Script Management:

Custom Scripts

  1. Complete MFA:
Custom Scripts

  1. Click + Add to upload a new script.

  2. Select the desired service from the drop-down. Currently Workspace is the only service with functionality.

  3. In the File box, browse to and select the script you want to upload.

  4. Optionally enter a description.

  5. Click Save:

Custom Scripts

You will now see that the script is available within Atria:

Custom Scripts

  1. Restart the Atria Provisioning Service in Windows services to apply the changes. This needs to be done to implement the script into the provisioning engine so ensure you complete this whenever adding new scripts.
info

If you are running the script on a remote environment, you will need to restart the Atria Provisioning Service on the remote provisioning server to apply the changes.

To learn about implementing your scripts into the Workspace service, refer to Workspace Automation.

For any questions about the future of Uploading Scripts or if you are in need of assistance, please contact support@getatria.com.