delete_role

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

Zone type

Classic and hierarchical

Syntax

delete_role

Abbreviation

dlr

Options

This command takes no options.

Arguments

This command takes no arguments.

Return value

This command returns nothing if it runs successfully.

Examples

delete_role

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

Related commands

Before you use this command, you must have a currently selected role stored in memory. The following commands enable you to view and select the role to work with:

  • get_roles returns a Tcl list of roles in the current zone.
  • list_roles lists to stdout all roles in the currently selected zone.
  • new_role creates a new role and stores it in memory.
  • select_role retrieves a role from Active Directory and stores it in memory.

After you have a role stored in memory, you can use the following commands to work with that role: