select_object

Use the select_object command to retrieve the specified Active Directory object and its attributes from Active Directory. This command stores the object in memory and makes it the currently selected Active Directory object. You can use options to retrieve the rootDSE of the object or to list specific attributes to retrieve for the object.

Zone Type

Not applicable

Syntax

select_object [-rootdse] [-attrs a1[,a2,...]] dn

Abbreviation

slo

Options

This command takes the following options:

Option Description
-rootdse Returns the rootDSE of the specified object instead of the object.
-attrs a1[,a2,...] Specifies the attributes to retrieve and store in memory. If you use this option, only the attributes you name (a1, a2, a3, and so on) are retrieved. This option is useful if you want to limit the number of attributes returned or want to return attributes not normally returned by Active Directory. If you do not use this option, ADEdit retrieves the attributes normally returned by Active Directory for the selected object type.

Arguments

This command takes the following argument:

Argument Type Description
dn DN Required. Specifies the distinguished name (DN) of an Active Directory object.

Return Value

This command returns nothing if it runs successfully.

Examples

select_object “cn=users,dc=acme,dc=com”

This example returns the container object cn=users,dc=acme,dc=com and its attributes, and stores it in memory as the currently selected Active Directory object.

The following commands enable you to view and select the object to work with:

  • get_objects performs an LDAP search of Active Directory and returns a Tcl list of the distinguished names of objects matching the specified search criteria.
  • new_object creates a new Active Directory object and stores it in memory.

After you have an Active Directory object stored in memory, you can use the following commands to work with that object’s attributes, delete the object, or save information for the object:

  • add_object_value adds a value to a multi-valued field attribute of the currently selected Active Directory object.
  • delete_object deletes the selected Active Directory object from Active Directory and from memory.
  • delete_sub_tree deletes an Active Directory object and all of its children from Active Directory.
  • get_object_field reads a field value from the currently selected Active Directory object.
  • remove_object_value removes a value from a multi-valued field attribute of the currently selected Active Directory object.
  • save_object saves the selected Active Directory object with its current settings to Active Directory.
  • set_object_field sets a field value in the currently selected Active Directory object.