create-file-user

creates a new file user

Synopsis

create-file-user [--help] [--authrealmnameauth_realm_name] 
[--target target 
[--groups user_groups[:user_groups]*] user_name

Description

The create-file-user subcommand creates an entry in the keyfile with the specified username, password, and groups. Multiple groups can be created by separating them with a colon (:). If auth_realm_name is not specified, an entry is created in the keyfile for the default realm. If auth_realm_name is specified, an entry is created in the keyfile using the auth_realm_name.

You can use the --passwordfile option of the asadmin(1M) command to specify the password for the user. The password file entry must be of the form AS_ADMIN_USERPASSWORD=user-password.

If a password is not provided, this subcommand fails if secure administration is enabled and the user being created is an administrative user.

This subcommand is supported in remote mode only.

Options

--help
-?: Displays the help text for the subcommand.
--target: This is the name of the target on which the command operates. The valid targets are config, instance, cluster, or server. By default, the target is the server.
--groups: This is the group associated with this file user.
--authrealmname: The name of the realm in which the new user is created. If you do not specify this option, the user is created in the "file" realm.

Operands

user_name: This is the name of file user to be created.

Examples

Example 1 Creating a User in the File Realm

This example creates a file realm user named sample_user. It is assumed that an authentication realm has already been created using the create-auth-realm subcommand.

asadmin> create-file-user 
--groups staff:manager 
--authrealmname auth-realm1 sample_user
Command create-file-user executed successfully

Exit Status

0: subcommand executed successfully
1: error in executing the subcommand