type=page
status=published
title=create-file-user
next=create-http.html
prev=create-domain.html
~~~~~~

= create-file-user

[[create-file-user-1]][[GSRFM00024]][[create-file-user]]

== create-file-user

Creates a new file user

[[sthref219]]

=== Synopsis

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

[[sthref220]]

=== 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
link:asadmin.html#asadmin-1m[`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.

[[sthref221]]

=== Options

asadmin-options::
  Options for the `asadmin` utility. For information about these
  options, see the link:asadmin.html#asadmin-1m[`asadmin`(1M)] help page.
`--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.

[[sthref222]]

=== Operands

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

[[sthref223]]

=== Examples

[[GSRFM475]][[sthref224]]

==== 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.

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

[[sthref225]]

=== Exit Status

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

[[sthref226]]

=== See Also

link:asadmin.html#asadmin-1m[`asadmin`(1M)]

link:create-auth-realm.html#create-auth-realm-1[`create-auth-realm`(1)],
link:delete-file-user.html#delete-file-user-1[`delete-file-user`(1)],
link:list-file-groups.html#list-file-groups-1[`list-file-groups`(1)],
link:list-file-users.html#list-file-users-1[`list-file-users`(1)],
link:update-file-user.html#update-file-user-1[`update-file-user`(1)]