The Custom PowerShell functionality in Nova allows almost any PowerShell scripts to be executed to perform custom tasks within your tenant organisations.
This functionality is accessible to users who have the any of the following roles:

  • System Administrator
  • Account Administrator

More details on the scripts, validation, parameters and so on, can be found here.

Creating a new custom script

Follow the steps below to add a new custom script:

  1. In the left menu, select
  2. Manage Administration > Custom PowerShell.
  3. Click on ‘Add’
  4. Give the custom PowerShell script a meaningful name.
  5. Select the online PowerShell-type that the script will run against. You can choose one of the following:
  • Exchange Online
  • Azure AD
  • MS online
  • MS Teams
  • SharePoint
  1. Enter the PowerShell script that should be executed.
  2. Click on Validate. (You will need to correct any errors before the final step)
  3. Save the script.

Here is an example script for setting a retention policy on a mailbox:

param( [Parameter(mandatory=$true)] $name, [Parameter(mandatory=$true)] $retentionPolicyName )

set-mailbox “$name” -RetentionPolicy “$retentionPolicyName”

To use this script, you would select ‘Exchange Online’ as the PowerShell type. After validating the script, you will see that two parameters were added to the bottom of the data entry page.
More details on the scripts, validation, parameters and so on, can be found here.

Editing or deleting an existing custom script

To edit or delete a script follow these steps:

  1. In the left menu, select
  2. Manage Administration > Custom PowerShell.
  3. Locate the script you want to edit or delete, and select it.
  4. Either:
  • Click Edit, make desired changes, and click Save to apply all the edits.
  • Click Delete and confirm the delete action.

Executing a script

To run a script follow these steps:

  1. In the left menu, select
  2. Manage Administration > Custom PowerShell.
  3. Locate the script you run and select it.
  4. Click on ‘Execute command’
  5. You must specify:
  • The tenant you wish to execute the script on
  • Any required parameters. Note: You may need to scroll down the page in order to see the list of parameters
  1. Click on the ‘Execute’ button

Nova will now submit a job for this script to executed against the selected tenant. The following section explains how to check if the script ran successfully.

Reviewing the execution of a script

To verify that a script ran, follow these steps:
To run a script follow these steps:

  1. In the left menu, select
  2. Manage Administration > Jobs.
  3. Locate the script you ran, and review the status column to see if the script ran successfully or if it generated an error.

You can filter the list of jobs on the job screen in order to make it easier to find the required information. For more information on the jobs page, click here.
Note: In normal operation a notification will be generated when the job completes

Print Friendly, PDF & Email