Directory Objects
This page lets you add machines, groups, Organizational Units (OUs), and more, that you want Workspace Environment Management (WEM) to manage. You must add those objects to WEM so that the agent can manage them. After you add objects, a list of machines that have been added appears. Only the machines listed here are managed by WEM. You can use the search box to quickly search for objects you want. You can also use filters to refine your search.
Note:
Converting distinguished names to computer names can take some time. If the conversion is incorrect or fails, verify that the Cloud Connectors are working properly by viewing their health status. If the issue persists, contact Citrix Technical Support.
When agents on those machines register with the infrastructure service, the infrastructure service sends them the necessary machine-dependent settings related to the configuration set. To improve the user experience, the infrastructure service caches data related to the configuration set for the agents. Data caching allows the infrastructure service to retrieve data from the directory less frequently. The cache refreshes on an hourly basis. Changing agents to a different configuration set can take some time to take effect.
Tip:
To check whether agents on those machines are correctly registered with the infrastructure service, go to Monitoring > Administration > Agents.
You can add the following objects:
- Machines and groups
- OUs
- Non-domain-joined machines
Click Add object, select the object type, and then navigate through the directory to the objects you want to add. After adding objects of one type, you can switch to a different type to continue. After you have finished, click Add.
Add a machine or machine group
-
On the Directory Objects node, click Add object.
-
Select Computers and groups from the object type list.
-
Select a domain from the list and search for the machine or machine groups that you want to add.
Note:
If your domain list has expired, you can force refresh your domain list by clicking the refresh button.
-
Click the plus sign to add. Machines you add are listed in the table under the search box.
-
Select the configuration set to which you want to add them.
-
When you are finished, click Add.
Add machines in an OU
-
On the Directory Objects node, click Add object.
-
Select Organizational units from the object type list.
-
Select a domain from the list and search for the OUs you want to add.
Note:
If your domain list has expired, you can force refresh your domain list by clicking the refresh button. The location configuration option restricts the OU search scope to a specific location node to find the desired target OU quickly.
-
Click the plus sign to add. Objects you add are listed in the table under the search box.
-
Select the configuration set to which you want to add them.
-
When you are finished, click Add.
Add non-domain-joined machines
Note:
Non-domain-joined machines listed in Directory Objects are not shown in the list of machines available to be added to a configuration set.
-
On the Directory Objects node, click Add object.
-
Select Non-domain-joined machines from the object type list.
-
Search for the machines you want to add.
-
Click the plus sign to add. Machines you add are listed in the table under the search box.
-
Select the configuration set to which you want to add them.
-
When you are finished, click Add.
Edit machine, machine group, or OU details
-
On the Directory Objects node, select the object you want to edit and then select Edit from the action bar.
-
In the Edit object wizard, edit any of the following details and then click Save.
-
Name. The machine, machine group, or OU name.
-
Distinguished Name. The distinguished name (DN) of the selected machine or machine group. This name allows you to differentiate different OUs if they have the same name. This section is not available for objects of the machine catalog type.
-
Object type. The object type (machines, groups, OUs, or non-domain-joined machines).
-
Description. Additional information about the machine, machine group, or OU.
-
Configuration set. The configuration set to which you want to add the object.
-
Priority. Lets you configure priority between different machines or groups. The priority determines the order in which the actions you assign are processed. The greater the value, the higher the priority. Type an integer. If there is a conflict (for example, when mapping different network drives with the same drive letter), the machine or group with the higher priority prevails.
-
Object state. Controls whether to enable (Yes) or disable (No) the object. If disabled, the machine, machine group, or OU is not available to assign actions to, and actions assigned to it no longer take effect. Alternatively, you can toggle the state on or off by using the toggle in the State column of the Directory Objects page.
* Read-only details reported from the directory.
-
Note:
For objects of the machine catalog type, you can change only the configuration set. To change the name and description, use the Full Configuration interface of Citrix DaaS (formerly Citrix Virtual Apps and Desktops service).
Delete objects
Select the object that you want to delete and then select Delete from the action bar.
Advanced settings
Unbound agents
Control whether to apply settings to agents that are not bound to any configuration set. After you enable the following settings, go to the “Unbound Agents” configuration set and then configure the settings there so that you can control how unbound agents behave.
-
Apply settings to unbound agents. Lets you apply the settings of the “Unbound Agents” configuration set to agents that you have not yet added in Directory Objects.
- Include unbound non-domain-joined agents. Lets you control whether to apply the settings to unbound non-domain-joined agents.
Note:
With Apply settings to unbound agents enabled, if you add those unbound agents to a different configuration set, it can take up to an hour for the new settings to be applied.
Non-domain-joined agents
Set up binding rules for unbound non-domain-joined agents. A rule dictates which configuration set to bind the matching agents to. Each agent is evaluated against the rules in the order listed until a match is found. You can add up to 50 rules.
To create a rule, complete the following steps:
-
Click Create rule.
-
Configure settings as needed:
- Name. Name the rule.
-
Criteria. Add one or more criteria.
-
Device name. Enter a regular expression that describes device names to match. For example, if the machines you want to match are named PC-Sales-01, PC-Sales-02, PC-Sales-03, and so on, enter the following expression:
PC-Sales.*. -
IP address. Enter an IP address or an IP address range. You can also enter a regular expression that describes IP addresses to match. For example, if the addresses you want to match are 192.168.1.0 through 192.168.1.255, enter the following expression:
192\.168\.1\..*. - MAC address. Enter a comma-separated list of MAC addresses.
-
Device name. Enter a regular expression that describes device names to match. For example, if the machines you want to match are named PC-Sales-01, PC-Sales-02, PC-Sales-03, and so on, enter the following expression:
-
Select the configuration set to bind matching machines to.
-
After you finish, click Done to save and to exit.