new_object command to create a new Active Directory object and set the new object as the currently selected Active Directory object in memory. The new object has no field values set. The
new_object command does not save the new object to Active Directory. To save the new object, you must use
save_object. If you don’t save a new object, it will disappear when you select a new object or when the ADEdit session ends.
new_object command does not check to see if the new object conforms to Active Directory’s expectations for the new object in the location you specify. Active Directory will report any errors when you try to save the object.
This command takes no options.
This command takes the following argument:
Required. Specifies the distinguished name for the new object.
This command returns nothing if it runs successfully.
new_object “ou=Centrify,cn=Program Data,dc=acme,dc=com”
This example creates a new organizational unit
Centrify in the container
Program Data in the domain
acme.com and stores it in memory as the currently selected Active Directory object.
The following commands enable you to view and select Active Directory objects:
- 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.
- select_object retrieves an object with its attributes from Active Directory and stores it in memory.
After you have an object stored in memory, you can use the following commands to work with that 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.