new_object

Use the 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.

The 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.

Zone type

Not applicable

Syntax

new_object dn

Abbreviation

newo

Options

This command takes no options.

Arguments

This command takes the following argument:

Argument Type Description

dn

DN

Required. Specifies the distinguished name for the new object.

Return value

This command returns nothing if it runs successfully.

Examples

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.

Related commands

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.