user: Users
The user
utility is used for managing additional Control Panel
users.
Usage
user <command> [<login_name>] [
<option_1> [<param>]
[<option_2> [<param>]]
... [<option_N> [<param>]]
Example
The following command creates an additional user account Mary with the username mary@example.com. The user account will be created based on the role called webmaster, and the user will be able to access Control Panel and manage websites of a customer with username JDoe.
plesk bin user --create mary@example.com -owner JDoe -passwd sample -cname Mary -role webmaster
Commands
Command | Parameter | Description | Example |
---|---|---|---|
--create or -c
|
<login_name> |
Creates a user account. Requires the options Login can be an e-mail address or a word containing alphanumeric, dash, dot and underscore symbols. |
To create a user account for webmaster Mary, who will manage websites of JDoe: plesk bin user --create mary@example.com -owner JDoe -passwd sample -cname Mary -role webmaster |
--update or -u
|
<login_name> |
Updates user account settings. |
To change the password for the user mary@example.com to 12345: plesk bin user --update mary@example.com -passwd 12345 |
--delete or -d
|
<login_name> |
Removes a user account. |
To remove the user account with the username mary@example.com: plesk bin user --delete mary@example.com |
--info or -i
|
<login_name> |
Displays user account information. |
To retrieve the info on the account with the username mary@example.com: plesk bin user --info mary@example.com |
--help or -h
|
Displays help on the utility use. |
To view help on the use of this utility: plesk bin user --help |
Options
Option | Parameter | Description | Example |
---|---|---|---|
-cname |
<string> |
Specifies the user’s contact name. Required with the |
To change a name for the user mary@example.com to Jane: plesk bin user --update mary@example.com -cname Jane |
-role |
<existing role name> |
Specifies the user role assigned to the user account. Roles define what Control Panel users can do in the Panel. |
To create a user account for webmaster Mary, who will manage websites of JDoe: plesk bin user --create mary@example.com -owner JDoe -passwd sample -cname Mary -role webmaster |
-passwd |
<password> |
Specifies a user’s password Required with the |
To change the password for the user mary@example.com to 12345: plesk bin user --update mary@example.com -passwd 12345 |
-status |
enabled|disabled |
Activates or suspends a user account. Suspended user accounts cannot log in to Control Panel. |
To suspend the user account mary@example.com: plesk bin user --update mary@example.com -status disabled |
-phone |
<number> |
Specifies user’s phone number. |
To set phone number in the personal info of the user with the login name mary@example.com to 1234567: plesk bin user --update mary@example.com -phone 1234567 |
-owner |
<username> |
Specifies the username of a Panel user for which an additional user account is created. |
To create a user account for webmaster Mary, who will manage websites of JDoe: plesk bin user --create mary@example.com -owner JDoe -passwd sample -cname Mary -role webmaster |
-company |
<string> |
Specifies a user’s company name. |
To set company name in the personal info of the mary@example.com account to MegaCompany Inc.: plesk bin user --update mary@example.com -company "MegaCompany Inc." |
-fax |
<number> |
Specifies a user’s fax number. |
To set fax number in the personal info of the account mary@example.com to 5556676677: plesk bin user --update mary@example.com -fax 5556676677 |
-address |
<string> |
Specifies a user’s postal address. |
To set postal address in the personal info of the account mary@example.com to Elm str. 17: plesk bin user --update mary@example.com -address "Elm str. 17" |
-city |
<string> |
Specifies a user’s city. |
To set city in the personal info of the account mary@example.com to New York: plesk bin user --update mary@example.com -city "New York" |
-state |
<string> |
Specifies a user’s state/province. |
To set state in the personal info of the account mary@example.com to NY: plesk bin user --update mary@example.com -state NY |
-zip |
<string> |
Specifies a user’s ZIP or postal code. |
To set the postal code in the personal info of the account mary@example.com to 123123: plesk bin user --update mary@example.com -zip 123123 |
-country |
<string> |
Specifies a user’s country: a two-letters upper-case code in compliance with ISO 3166. |
To set country in the personal info of the account mary@example.com to United States: plesk bin user --update mary@example.com -country US |
-im-type |
<integer> |
Specifies a user’s instant messenger type. 1 - ICQ. 2 - Jabber. 3 - AIM. 4 - Skype. 0 - Other. |
To set an instant messenger for the user account mary: plesk bin user --update mary -im-type 1 -im 123456789 |
-im |
<string> |
Specifies a user’s instant messenger number. | |
-external-email |
<string> |
Specifies an external email address for an additional user. |
To set an external email address for the user account mary: plesk bin user --update mary -external-email usermary@example.com |
-comment |
<string> |
Specifies additional information about the user. |
To add a comment for the user account mary: plesk bin user -u mary -comment "This is a comment" |
-email |
<string> |
Specifies an email address for the additional user within the subscription to which the user belongs. If you specify a non-existing email account within the subscription, it will be created. |
To set an email account under the subscription example.com for the user account mary: plesk bin user --update mary -email usermary@example.com |
-subscription-name
|
<subscription_name> |
Allows a user to access only a specified subscription within a hosting account. |
To allow the user with the account mary@example.com access only the example.com subscription: plesk bin user --update mary@example.com -subscription-name example.com |
-for-all-subscriptons |
Allows a user to access all subscriptions within a hosting account |
To allow the user with the account mary@example.com access all subscriptions: plesk bin user --update mary@example.com -for-all-subscriptions |
|
-locale |
<locale_code> |
Sets the locale for the user. |
To set the locale for the user account mary to en-US: plesk bin user -u mary -locale en-US |