ipa-adduser (1) - Linux Manuals

ipa-adduser: Add a user

NAME

ipa-adduser - Add a user

SYNOPSIS

ipa-adduser [OPTION]... user

DESCRIPTION

Adds a user with username user.

OPTIONS

-c, --gecos=gecos

Set the SM]GECOS field to gecos. The SM]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.