3.1 General Object Tasks

This section contains steps for basic tasks you will use when managing your eDirectory tree:

3.1.1 Browsing the eDirectory Tree

The View Objects button (View Objects button) in NetIQ iManager lets you search or browse for objects in your eDirectory tree. You can view the structure of your tree and right-click objects to perform tasks. The tasks available depend on the type of object you select.

The eDirectory Object Selector page in NetIQ iManager also lets you search or browse for objects. In most entry fields in NetIQ iManager, you can specify an object name and context, or you can click the Object Selector button Object Selector button to search or browse for the object you want. Selecting an object in the eDirectory Object Selector page inserts the object and the object's context into the entry field.

This section contains the following information:

Using the View Object Button

Use the techniques described below to locate the specific objects you want to manage.

Using Browse

  1. In NetIQ iManager, click the View Objects button View Objects button.

  2. Click Browse.

  3. Use the following options to browse for an object:

    Option

    Description

    Lets you move down one level in the tree.

    Lets you move up one level in the tree.

    Context

    Lets you specify the name of the container whose contents you want to view.

    To use this option, specify the name of the container you want, then click Apply.

    Name

    Lets you specify the name of an object.

    You can use an asterisk (*) as a wildcard character in this field. For example, g* finds all objects starting with “g,” such as Germany or Greg, and *te finds all entries ending in “te,” such as Kate or Corporate.

    To use this option, type the name you want, then click Apply.

    Type

    Lets you specify the type of object you want to search for. The default is All Available Types.

    To use this option, select an object type from the drop-down list, then click Apply.

  4. When you find the object you are looking for, right-click the object, then choose from the list of available tasks to perform.

Using Search

  1. In NetIQ iManager, click the View Objects button View Objects button.

  2. Click Search.

  3. In the Context field, specify the name of the container you want to search in.

    Click Search Sub-containers to include all subcontainers located within the current container in the search.

  4. In the Name field, specify the name of the object you want to search for.

    You can use an asterisk (*) as a wildcard character in this field. For example, g* finds all objects starting with “g,” such as Germany or Greg, and *te finds all entries ending in “te,” such as Kate or Corporate.

  5. Select the type of object you want to search for from the Type drop-down list.

  6. Click Search.

  7. When you find the object you are looking for, right-click the object, then choose from the list of available tasks to perform.

Using the Object Selector Button

Use the techniques described below to locate the specific objects you want to manage.

Using Browse

  1. Click the Object Selector button Object Selector button on an iManager property page.

  2. Click Browse.

  3. Use the following options to browse for an object:

    Option

    Description

    Lets you move down one level in the tree.

    Lets you move up one level in the tree.

    Look In

    Specify the name of the container whose contents you want to view, then click Apply.

    Look for Objects Named

    Lets you specify the name of an object.

    You can use an asterisk (*) as a wildcard character in this field. For example, g* finds all objects starting with “g,” such as Germany or Greg, and *te finds all entries ending in “te,” such as Kate or Corporate.

    To use this option, type the name you want, then click Apply.

Using Search

  1. Click the Object Selector button Object Selector button on an iManager property page.

  2. Click Search.

  3. In the Start Search In field, specify the name of the container you want to search in.

    Click Search Sub-containers to include all subcontainers located within the current container in the search.

  4. In the Search For Objects Named field, specify the name of the object you want to search for.

    You can use an asterisk (*) as a wildcard character in this field. For example, g* finds all objects starting with “g,” such as Germany or Greg, and *te finds all entries ending in “te,” such as Kate or Corporate.

  5. Click Search.

3.1.2 Creating an Object

  1. In NetIQ iManager, click the Roles and Tasks button Roles and Tasks button.

  2. Click Directory Administration > Create Object.

  3. Select an object from the list of available object classes, then click OK.

  4. Specify the information requested, then click OK.

    The information requested depends on the type of object you are creating. Click Help button for more information.

  5. Click OK.

3.1.3 Modifying an Object's Properties

  1. In NetIQ iManager, click the Roles and Tasks button Roles and Tasks button.

  2. Click Directory Administration > Modify Object.

  3. Specify the name and context of the object or objects you want to modify, then click OK.

  4. Edit the property pages you want.

    Click Help button for more information on specific property pages.

  5. Click OK.

3.1.4 Copying Objects

This option lets you create a new object with the same attribute values as an existing object, or copy attribute values from one object to another.

  1. In NetIQ iManager, click the Roles and Tasks button Roles and Tasks button.

  2. Click Directory Administration > Copy Object.

  3. In the Object to Copy From field, specify the name and context of the object you want to copy.

  4. Select one of the following options:

    • Create New Object and Copy Attribute Values

    • Copy Attribute Values to an Existing Object

  5. If you want to copy access control list (ACL) rights to the object you are creating/modifying, select Copy ACL Rights.

    Copying ACL rights can take additional processing time depending upon your system and networking environment.

  6. Click OK.

3.1.5 Moving Objects

  1. In NetIQ iManager, click the Roles and Tasks button Roles and Tasks button.

  2. Click Directory Administration > Move Object.

  3. In the Object Name field, specify the name and context of the object or objects you want to move.

  4. In the Move To field, specify the container you want to move the object or objects to.

  5. If you want to create an Alias in the old location for each object being moved, select Create an Alias in Place of Moved Object.

    This allows any operations that are dependent on the old location to continue uninterrupted until you can update those operations to reflect the new location.

  6. Click OK.

3.1.6 Deleting Objects

  1. In NetIQ iManager, click the Roles and Tasks button Roles and Tasks button.

  2. Click Directory Administration > Delete Object.

  3. Specify the name and context of the object or objects you want to delete.

  4. Click OK.

3.1.7 Renaming Objects

  1. In NetIQ iManager, click the Roles and Tasks button Roles and Tasks button.

  2. Click Directory Administration > Rename Object.

  3. In the Object Name field, specify the name and context of the object you want to rename.

  4. In the New Object Name field, specify the new name for the object.

    Do not include the object's context in the New Object Name field.

  5. If you want to create an Alias for the object being renamed, select Create an Alias in Place of Renamed Object.

    This allows any operations that are dependent on the old object name to continue uninterrupted until you can update those operations to reflect the new name.

  6. If you want to save the old object name, select Save Old Name.

    This saves the old name as an additional (unofficial) value of the Name property. Saving the old name lets users search for the object based on that name. After renaming the object, you can view the old name in the Other Name field on the General Identification tab for that object.

  7. Click OK.