Skip to main content

Atria Extensions

Overview​

Extensions add tasks and integrations to Atria. Importing an extension makes its functionality available to the platform; a job defines when a task runs and the configuration it uses.

Use this section to install an extension and configure its task. For shared instructions on scheduling, secrets, manual execution and viewing logs, see Jobs System.

ExtensionPurposeGuide
AdUserSyncRead account status and mapped user attributes from Active Directory into Atria for existing provisioned users.User AD Sync Job
DatabaseMaintenanceTrim retained operational data and perform database maintenance.Database Maintenance
PowerShellExecute custom PowerShell scripts through the Provisioning Service.PowerShell Job
AutoTaskPSA, ConnectWiseManage, KaseyaBmsConnect Atria billing to a PSA system.PSA Extension Installation

The User AD Sync Job reads AD information back into Atria. The separate AD Sync Service synchronises customer-domain users and passwords into a hosted AD environment. Use the guide for the process you want to configure.

Installation​

Run extension commands in an administrative PowerShell session on the Provisioning Server, with the Atria tools available and the Atria service-schema credentials configured as described in the installation guide.

Check whether a component is already installed:

Get-AtriaComponent -Name AdUserSync

Import a named extension, or an array of extensions:

Import-AtriaExtension -Extension AdUserSync
Import-AtriaExtension -Extension @('AdUserSync', 'DatabaseMaintenance', 'PowerShell')

Import parameters​

ParameterPurpose
-ExtensionOne extension name or an array of names from the table above. Use this to install or update specific extensions.
-InstalledSelect installed extensions for updating. Without -Version, the command selects those reported as out of date. Use separately from -Extension.
-VersionRequest a specific available package version. Without this parameter, the command selects the latest available version.
-RestartServicesRestart the Atria Agent after importing. Defaults to $true; use -RestartServices:$false to defer the restart.

For example, update installed extensions:

Import-AtriaExtension -Installed

If you defer the restart, arrange the required service restart before expecting the updated extension to be available. Refresh the Jobs page after importing and check that the relevant task is listed.

Configuration​

Open Configuration > Provisioning & Debug Tools > Jobs. Check for an existing job before adding another: Atria can create jobs during installation, upgrades or service startup, depending on the feature and version.

Each extension guide explains its own task settings. The Jobs System guide explains the shared controls and automatically created jobs. Feature-managed jobs should be configured through their owning feature where applicable.