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.