ipa-adduser(1)

NAME
ipa-adduser - Add a user

SYNOPSIS
ipa-adduser [OPTION]... user

DESCRIPTION
Adds a user with username user.

OPTIONS

-c, --gecos=gecos
    Set the GECOS field to gecos. The GECOS field is traditionally used to store user's real name and other information.

-d, --directory=directory
    Set user's home directory to directory. If this option is not present, a default specified by the freeIPA configuration is used.

-f, --firstname=givenName
    Set user's first name to givenName.

-l, --lastname=familyName
    Set user's last name to familyName.

-p, --password=password
    Set user's password to password.

-P  Prompt for the user's password.

-s, --shell=shell
    Set the user's login shell to shell. If this option is not present, a default specified by the freeIPA configuration is used.

-G, --groups=groups
    Add this user to one or more groups in groups. groups is a comma-separated list of groups. Each group must already exist.

-k, --krb-principal=principal
    Set this user's principal to principal. By default the principal is set to user.

-M, --mailAddress=mail
    Set this user's e-mail address to mail.

--addattr attr=value
    Adds value to attribute attr. Attributes set this way are done after other options. If an attribute is listed more than once or already exists in the entry, it is considered a multi-valued attribute and a list of the values is created.

--setattr attr=value
    Set attribute attr to value. Any existing value will be replaced with value.

-v, --verbose
    Display the XML-RPC request and response for more verbose debugging output.

The mandatory fields are: user, first name and last name. If any of these are not included on the command line you will be asked interactively. The password is asked interactively if not passed on the command-line but it isn't mandatory. Leaving both values blank will leave the password unset on the account. If no options are passed then all questions are asked.

EXIT STATUS
The exit status is 0 on success, nonzero on error.