...
{anchor:acfgl}
h1. commadmin user create
The {{commadmin user create}} command creates a single user in the LDAP directory. To create multiple users, use the {{-i}} option.
h2. Syntax
{noformat}
commadmin user create -D <login> -F <firstname> -n <domain> -L <lastname> -l <userid>
-w <password> -W <password> [-A [+]<attributename>:<value>] [-d <domain>]
[-I <initial>] [-h] [-?] [-i <inputfile>] [-p <AM port>] [-s] [-v] [-V] [-X <AM host>]
[-S mail [-E <email>] [-H <mailhost>]]
[-S cal [-B <DWPHost>] [-E <email>] [-k <calid_type>] [-J <First Day of Week>] [-T <time zone>]]
[-S im]
{noformat}
{anchor:acfgn}
h2. Options
The following options are mandatory:
||Option ||Description ||
|{{-D}} _login_ |The user ID of the user with permission to execute this command. |
|{{-F}} _firstname_ |The user’s first name; must be a single word without any spaces. |
|{{-n}} _domain_ |The domain of the user specified with the {{-D}} option. |
|{{-l}} _userid_ |The user’s login name.\\
Values entered with this option are limited to printable ASCII characters. For mail users, the following additional restrictions apply:\\
* These characters are not allowed: % * ? & / : \ \\
* You cannot enter a {{–}} (dash) as the leading character. The {{–}} is reserved to indicate negative rights. That is, the IMAP ACL extension reserves a leading {{–}} to deny permissions to the access rights that follow it in the ACL.\\
* You cannot enter {{group=}} as the leading term. It is reserved for group IDs\\
* These words are reserved and are not allowed: {{anonymous}}, {{anybody}}, {{anyone}}, {{anyone@}}_domain_ |
|{{-w}} _password_ |The password of the user specified with the {{-D}} option. |
|{{-W}} _password_ |The password of the user that is being created.\\
You may also specify _password_ via a text file, _password_{{.txt}}.\\
For example, if you specify {{-W}} {{mypassword.txt}}, and the content of the {{mypassword.txt}} file is {{secret}}, the {{commadmin}} utility takes the string {{secret}} as the password.\\
Note that if you specify {{-W}} {{mypassword.txt}}, and the {{mypassword.txt}} file does not exist, the {{commadmin}} utility takes the string {{mypassword.txt}} itself as the password. |
|{{-L}} _lastname_ |The user's last name. |
The following options are non-mandatory:
||Option ||Description ||
|{{-A}}[+] _attributename_:_value_ |An attribute to modify. The _attributename_ is defined in the LDAP schema and _value_ replaces any and all current values for this attribute in the directory. Repeat this option to modify multiple attributes at the same time, or to specify multiple values for the same attribute.\\
A “+” before the _attributename_ indicates adding the value to the current list of attributes. |
|{{-d}} _domain_ |Domain of the user. If {{-d}} is not specified, the domain specified by {{-n}} is used. |
|{{-i}} _inputfile_ |Reads the command information from a file instead of the command line.\\
An option value specified in the input file overrides any value for the same option set in the command line. |
|{{-I}} _initial_ |User's middle initial. |
|{{-h}}, {{–?}} |Prints command usage syntax. |
|{{-p}} _AM port_ |Specifies an alternate TCP port where the Access Manager is listening. If not specified, the default _AM port_ is used, or Port 80 is used if no default was configured at install time. |
|{{-s}} |Use SSL (Secure Socket Layer) to connect to the directory. |
|{{-v}} |Enable debugging output. |
|{{-V}} |Prints information about the utility and its version. |
|{{-X}} _AM host_ |Specifies the host on which the Access Manager is running. If not specified, the default _AM host_ is used, or the localhost if no default was configured at install time. |
|{{-S}} _service_ |Adds the specified service to the user during creation. _service_ can have the value of a single service or multiple services. The valid _service_ values are {{mail}}, {{cal}}, and {{im}}_._ These values are case-insensitive.\\
The list of services is separated by the comma (,) delimiter.\\
For Example:\\
{{-S mail,cal,im}} |
|The following options are only allowed if the {{-S}} {{mail}} option is specified: | |
|{{-E}} _email_ |The email address of the user. |
|{{-H}} _mailhost_ |The mail host of the user. |
|The following options are only allowed if the {{-S}} {{cal}} option is specified: | |
|{{-B}} _DWPHost_ |DNS name of the back end calendar that hosts the user’s calendar. |
|{{-E}} _email_ |The email address of the calendar user. |
|{{-J}} _First Day of Week_ |First day of the week shown when the calendar is displayed in the calendar server user interface. The valid values are 0-6 (0 is Sunday, 1 is Monday, and so on). |
|{{-k}} _calid_type_ |Specifies the type of calendar id that is created. The accepted values are {{legacy}} and {{hosted}}. If {{-k legacy}} is specified, only the calendar id is used (for example, {{jsmith}}). If {{-k hosted}} is specified, the calendar id plus domain is used (for example, {{jsmith@sesta.com}}).\\
If the {{-k}} option is not specified, the default is to use the calendar id plus domain ({{hosted}}).\\
You can set the value of the calendar id type that is created if the {{-k}} option is not specified. To do so, add the following parameter to the {{resource.properties}} file: \\
{{switch-caltype=}}_value_ \\