ADD NETWORK/ADD COMMUNITY/ADD TELECOM
Function
Adds a regular, community regular, or remote user.
Syntax
ADD class userID first i last dept pw postaddr phone1 phone2 UG# UG1...UGn
Parameters
class |
Network |
Creates a regular user. |
|
Community |
Creates a community regular user. |
|
Telecom |
Creates a remote user. |
userID |
The user ID. |
first |
The first name. Optional unless i is also used. |
i |
The initials. Optional. |
last |
The last name. |
dept |
Not used; always include a pair of quotation marks in the script. |
pw |
The user's password. |
postaddr |
The postal address. Optional. Use \r to enter a carriage return. |
phone1 |
The phone number. Optional. |
phone2 |
The fax number. Optional. |
UG# |
The number of user groups to follow. |
UG1...UGn |
The user groups to which the user will belong. |
Example
To add a regular user Susan A. Bram, with user ID “SBRAM” and password “broccoli”, and to put her into the Employees and East Coast user groups, you would enter:
ADD NETWORK SBRAM Susan A Bram "" broccoli "123 Main St.\rToronto" "" "" 2 Employee "East Coast"
To add remote user Susan A. Bram, with user ID “SBRAM” and password “broccoli”, and to put her into the Employees and East Coast user groups, you would enter:
ADD TELECOM sbram Susan A Bram "" broccoli "123 Main St.\rToronto" "" "" 2 Employee "East Coast"
The \r puts a carriage return in the "Address" field.
Comments
If you use the ADD command, and make a mistake in any of the parameters after the <dept> parameter (for example, if you spell the user group name incorrectly), FirstClass still adds an account for that user. To correct this, either delete the account, unsend the message, correct the error, and resend, or correct the information on the user information form.
If you want a user to be prompted to change his or her password the first time the user logs in, create a password that does not meet the criteria set by the password security.
One of the most common errors is to exclude the number of user groups (UG#) in the script. The server console will show the phrase "Type a number between 0 and 255" if you fail to include the number of user groups. Another common error is failing to put the names of groups that contain a space in quotation marks. If you mistype the name of a user group, the server console will indicate that the group does not exist, and list error 1081.
If the user ID already exists, the server console will indicate error 1031.
If the exact name already exists the server console will indicate error 1080. An example of an exact name would be creating a second Susan A. Bram, with a user ID of susan.
If there are no Regular licenses available, the server console will indicate error 1018.
Related commands
Use the PUT USER command to create additional scripts that would add information unsupported by the ADD command. For example, the following script would add a mail alias (field ID 1252), a voice DN (field ID 1255), and a voice password (field ID 1256) for Susan Bram:
PUT USER sbram 1252 0 sabram 1255 0 9055551212 1256 0 1212
| 