PreviousNext

principal rename

This operation changes the name of a specified principal. The syntax is:

principal rename principal_name -to new_principal_name

Options

-to new_principal_name
Used with the rename operation, specifies the new name of the principal.

Description
The principal rename operation changes the name of a specified principal. The argument is a single name of a principal to be renamed. Takes a required -to option with a value of the new name. The value cannot be a list. Returns an empty string on success.

Privileges Required
You must have r (read) and f (full name) permissions to the registry object for the specified principal.

Examples

dcecp> principal rename K_Doe -to K_Smith
dcecp>

dcecp> principal list K_Doe
Error: Registry object not found
dcecp>