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.
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
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 choosing one of the refresh options. Refresh records updates the selected record or the list of records and Requery target names updates the target names.
-
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.
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, or OUs).
-
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.
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.
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.