Skip to main content

Workspace Group OU Configuration

Overview​

Workspace Items in Atria are linked directly to Active Directory groups. By default:

  • Private Workspace Items are stored under the Customer OU.
  • Shared Workspace Items are stored under CortexSystem > Services > WorkSpace > Shared Resources.

This guide outlines how to modify the WSResourceContainer configuration key to change the OU structure for both Private and Shared Workspace Items.

To make changes, ensure you have read/write access to the Config Service. If you encounter any issues, please contact us at support@getatria.com for assistance.

Understanding the Configuration Keys and Config Value​

The command for changing the configuration key with an example ConfigValue is as following:

Set-AtriaConfig -ConfigKey 'WSResourceContainer' -ConfigValue '{"ActiveDirectory":"Groups","ActiveDirectory:Common":"Shared Resources,WorkSpace,Services,CortexSystem"}' -UseEnvironment

  • ActiveDirectory: Defines the OU for Private Workspace Items.

  • ActiveDirectory:Common: Specifies the path for Shared Workspace Items.

  • The second half of the key value pair defines the path to the desired OU in Active Directory. The example will create private groups in an OU named 'Groups' within the customer OU, and create shared items in the 'Shared Resources' OU, within the 'Workspace OU', within the 'Services' OU, within the 'CortexSystem' OU.

Configuring Private Workspace Items​

Private Workspace Items are created within the customer's OU. To create an OU called Workspace Groups within the customer OU, run the following command in an administrative PowerShell window on your Provisioning Server:

Set-AtriaConfig -ConfigKey 'WSResourceContainer' -ConfigValue '{"ActiveDirectory":"Groups"}' -UseEnvironment

This updates the ActiveDirectory key, changing where Private items are stored.

Configuring Shared Workspace Items​

Shared Workspace Items are stored in a common OU structure. To change the root OU of Shared Groups to Shared Groups under Customers, run the following command in an administrative PowerShell window on your Provisioning Server:

Set-AtriaConfig -ConfigKey 'WSResourceContainer' -ConfigValue '{"ActiveDirectory:Common":"Shared Groups,Customers"}' -UseEnvironment

This modifies the ActiveDirectory:Common key, updating the path for Shared items.

You can update both properties at the same time using the syntax below:

Set-AtriaConfig -ConfigKey 'WSResourceContainer' -ConfigValue '{"ActiveDirectory":"Workspace Groups","ActiveDirectory:Common":"Shared Groups,Customers"}' -UseEnvironment

Checking the Current Configuration​

To view and verify the current Workspace Group OU configuration, run the following PowerShell command on the Provisioning Server:

Get-AtriaConfig -ConfigKey WSResourceContainer -UseEnvironment

The output shows the current configuration:

{
  "ActiveDirectory": "WorkSpace Groups",
  "ActiveDirectory:Common": "Shared Resources,WorkSpace,Services,CortexSystem"
}