Active Directory management & automation

Automatically set profile path for Remote Desktop Services

Adaxes can be configured to automatically update the Remote Desktop Services settings for newly created or modified Active Directory users. In this tutorial, you will learn how to create a Business Rule that will automatically set the Remote Desktop Services Profile path for new users using a template like '\\SERVER\Profiles\%username%'.

In Active Directory, Remote Desktop Services settings are configured via the Remote Desktop Services Settings property of user objects. To automatically set the Remote Desktop Services profile path for new users, you need to create a Business Rule that will automatically launch after a new user is created and update the Remote Desktop Services Settings property of this user.

1Launch Adaxes Administration Console, right-click your Adaxes service, point to New and click Business Rule. The Create Business Rule wizard will open.

Launching the Create Business Rule wizard

2Enter the name for the new Business Rule, and click Next.

3Here you need to specify when the new Business Rule must be executed. As we want to set the Remote Desktop Services profile path after a new user is created, do the following:

  • Select User in the Object Type list.
  • Select After in the Operation section.
  • Select Creating a User in the Operation section and click Next.

Selecting the triggering operation for the Business Rule

4 At the next step, you need to specify what the Business Rule will do when a new user is created. To update the Remote Desktop Services Settings property of the user, do the following:

  • Click the Add Action link.
  • In the dialog that opens, select the Update the User action.
  • In the Action Parameters section, click Add.

Add 'Update User' action

  • In the dialog that opens, select the Remote Desktop Services Settings property in the Property to modify field.
  • Click the Edit button embedded in the New value field.
  • In the Remote Desktop Services Settings dialog, specify the value for the Remote Desktop Services profile path in the TerminalServicesProfilePath field.
  • Click OK three times.

Specify a template for the Remote Desktop Services Settings property

To set a unique profile path for each user, you need to use value references (e.g. %username%). When the Business Rule is executed, these value references will be replaced with the property values of the new user. For example, if you enter the following template for the profile path: '\\SERVER\%department%\%username%', the value references contained in this template will be replaced with the values of the Department and User Logon Name properties of the user (e.g. \\SERVER\Sales\johndoe).

5 Optionally, you may want the new Business Rule to set the Remote Desktop Services profile path, only if certain conditions are met. For example, to set the profile path, only if a new user is created under a specific OU, perform the following steps:

  • Select the action/condition set (click the created action to highlight the set), and click the Add Condition icon.
  • In the dialog that opens, select the If located under <location> condition type.
  • In the Condition Parameters section, click Select Location and select an OU or container.
  • Click OK.

Adding Business Rule condition

When finished, click Next.

6 Here, at the Activity Scope page, you need to specify where in Active Directory a user must be created to trigger this Business Rule. Click Add.

Specifying rule activity scope

7 In the Business Rule Activity Scope dialog, you need to specify the Active Directory locations where the Business Rule will be effective. Select one of the following items:

  • All Objects - select if you want this Business Rule to be executed when a user is created in any AD domain managed by the Adaxes service.

  • Specific Domain - select if you want this Business Rule to be executed when a user is created in the AD domain you specify.

  • OU or Container - select if you want this Business Rule to be executed only when a new user is created under the selected OU or container.

Select the item you need and click Add. When finished, click OK.

8 The specified activity scope items will be displayed in the Assignments list. Click Finish.

Now, when the Business Rule is complete, every time a new user is created in AD (no matter in which way - using Administration Console, Web Interface, during data import, via PowerShell scripts, etc.), Adaxes will automatically set the Remote Desktop Services profile path for this user according to the template you have specified.

? Waiting

Progress status: Checking...