delete_object

Use the delete_object command to delete the currently selected Active Directory object from Active Directory and from memory. You cannot use other commands to manage the object after deletion because there will be no currently selected Active Directory object in memory.

Note:   Do NOT use the delete_object command to delete an Active Directory user or group that has been provisioned. If you use delete_object to delete a provisioned user or group, you create orphan user or group UNIX data objects. Instead, use the delete_zone_user or delete_zone_group command. In addition, you would use the select_zone_user and select_zone_group rather than select_object to select the user or group. For information about displaying orphan accounts, see the list_zone_users and list_zone_groups.

Zone type

Not applicable

Syntax

delete_object

Abbreviation

dlo

Options

This command takes no options.

Arguments

This command takes no arguments.

Return value

This command returns nothing if it runs successfully.

Examples

delete_object

This example deletes the currently selected Active Directory object from Active Directory and from memory.

Related commands

Before you use this command, you must have a currently selected Active Directory object stored in memory. 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 matching objects.
  • new_object creates a new Active Directory object and stores it in memory.
  • select_object retrieves an object with its attributes from Active Directory and stores it in memory.

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

  • delete_sub_tree deletes an Active Directory object and all of its children from Active Directory.
  • save_object saves the selected Active Directory object with its current settings to Active Directory.