You must use the vCloud Application Director CLI to create users and groups.

Verify that your user account has the ROLE_SYSTEM_ADMIN system administrator role assigned to it.

Familiarize yourself with the roles available for users. See Predefined Users, Groups, and Roles.

Verify that you know the password for the darwin_user. This password was set during installation. See Start the vCloud Application Director Appliance.

Start the vCloud Application Director CLI. See Start the CLI Remotely.


In the roo shell prompt, press the Tab key to display the list of available commands.


Type the command to perform the appropriate action.



List usage information


Create a group

create-group --name GroupName --description Description

Create a user

create-user --username UserName --firstName FirstName --lastName LastName --enabled true --roles 
--group GroupName --email EmailAddress

If you run the --password parameter with the login command or a command that lets you add a password, your password is saved as plain text in the darwin-cli-history.log file located in the current directory. By default, the CLI deletes the log file. For added security, delete this log file.

If you specify all the roles shown in this example, the user is the equivalent of the admin user. Specify only the roles the specific user must have.

The valid values for the enabled option are true, yes, 1, false, no, and 0.

For a vCloud Application Director object or entity, if you use multiple words with spaces between the words, enclose the words in quotation marks.

For example, to create a group called Test Group, use the command create-group --name "Test Group".

Often after you enter a command, the system displays many details relating to the user, in addition to indicating whether the command was successful.

Use the CLI to perform tasks such as changing passwords or enabling and disabling accounts for users and groups. See Managing Users and Groups.