Goverlan
GUIDE MENU

MODIFYING THE LIST OF ROOT OBJECTS

The WMIX Browser view opens with a default list of pre-defined root objects. However, you can customize this list by removing or adding objects. The Browser view accepts WMI classes, associations and queries as root objects.

Adding a new root object

You can add a new root object in three ways:

  1. Click on the Search WMI... button in the main toolbar. Search for the object you want to add, select it and click on OK in the Search window. For more information about the search feature, see Searching for Objects.

  2. Right click within an empty area of the Browser view and select 'Add new root class object'. The Search WMI window opens. Search for the object you want to add, select it and click on OK in the Search window. For more information about the search feature, see Searching for Objects.

  3. You can also select any child object already queried in the browser view, right click on the mouse and select Add as root object from the context sensitive menu. You can only add associations and parent objects to the list of root objects. You cannot add an object instance, an association role or an object category (see Displaying Object Associations.)

Root objects versus child objects

When browsing through child associations, querying an object or an association only returns the instances which relate to the parent object through the selected association. For instance, querying the instances of the association Share to Directory for the share Goverlan results in a single entry 'c:datapjtechsoftwaregoverlan'. It is the only instance of Share to Directorywhich relates to the parent object Goverlan.

However, if you select to add the association object Share to Directory to the list of root objects and to query it, the association is no longer bound to a parent object and all instances of Share to Directory which exists on the system are returned.

Similarly, if you add the Directory object to the list of root objects and query it, all instances of a directory in the system will be eventually returned. Due to the potentially large number of directory objects on a file system, we do not advise to set the Directory object as a root object since it will take too long to receive a result set from such a query.

Adding a new root Query object

You can also add a WMI query object to the list of root objects. A WMI Query object is a powerful means to fine tune the information to be queried. You can restrict the attributes of an object to be returned and set conditions to narrow down the result set. Describing the full potential of a WMI query is outside the scope of this section. For more information, refer to Query WMI view.

To add a root Query object, click on Add Root Query Object button in the ribbon bar or right click in an empty area of the Browser view and select Add new root query object. Enter the name and query string of the object to add and click on OK.

 

Tip: When you select a root query object, the Information Panel shows its detailed information, including the query string.

Modifying a root Query object

To modify the configuration of a root query object, select it and:

  • Right click on the mouse and select Modify Query... from the context sensitive menu.

  • Click on the Modify Query... link located under Available Tasks in the Information Panel.

Tip: The pre-defined list of root objects includes two root query objects as examples: Computer System Identity and Network Adapters - Connected. TheComputer System Identity simply returns the essential attributes of the Win32_ComputerSystemProduct class object. The Network Adapters - Connected query uses a condition to only return the active network adapters on a system. Click on these root objects to look at the query string.

Adding new root objects from outside the Browser View

You do not need to be within the Browser view to add root objects. The Namespace & Class view as well as the WMI Query view allows you to add new Browser view root objects.

When navigating though the WMI namespaces and classes, you can pick any object and select Add Class to Browser View from its context sensitive menu. When entering query strings in the WMI Query view, you can click on the Add Query to Browser View button located at the top right corner of the view.

Removing a root object

To remove a root object, select it and:

  • Right click on the mouse and select Remove from root objects from the context sensitive menu.

  • Select View >> Remove from Root Objects from the main menu.

Note: You cannot remove the Computer System root object.

Resetting the list of root objects

At any time, you can reset the list of root objects to its pre-defined set. To do so, select View >> Reset View to Default from the main menu.