The client.exe utility is designed for the purpose of managing Plesk client accounts. The utility allows the following:
Location
%plesk_cli%
Usage
client.exe <command> [<login_name>] [
<option 1> <param> [<option 2> <param>] … [<option N> <param>]
]
Example
The following command creates the client account for John Doe for Parallels Plesk Panel administrator, sets JohnDoe as the login name and MyPass as the password, specifies the Unites States as the client's country, tells Parallels Plesk Panel not to send to Parallels Plesk Panel administrator a notification on the account creation, enables the use of the dedicated IIS application pool for this client, and allows the use of maximum 7% of CPU for the client's IIS application pool.
>client.exe --create JohnDoe -name "John Doe" -passwd MyPass -notify false -iis_app_pool true -cpu_usage 7
Commands
Command |
Parameter |
Description |
Example |
|---|---|---|---|
|
|
Creates a client account. Requires If client owner is not specified, a created client belongs to Parallels Plesk Panel administrator. |
To create the account for John Doe with the login name JohnDoe and password sample for the reseller Richard Roe: >client.exe --create JohnDoe -name "John Doe" -passwd "sample" -owner RichardRoe or >client.exe -c JohnDoe -name "John Doe" -passwd "sample" -owner RichardRoe |
|
|
Updates a client account. |
To change the login name from JohnDoe to John and set the password to 12345: >client.exe --update JohnDoe -login John -passwd 12345 or >client.exe -u JohnDoe -login John -passwd 12345 |
|
|
Removes a client account. |
To remove the client account with the login name JohnDoe: >client.exe --remove JohnDoe or >client.exe -r JohnDoe |
|
|
Outputs a client info. |
To retrieve the info on the account with the login name JohnDoe: >client.exe --info JohnDoe or >client.exe -i JohnDoe |
|
|
Enables a client account. |
To enable the account with the login name JohnDoe: >client.exe --on JohnDoe |
|
|
Disables a client account. |
To disable the account with the login name JohnDoe: >client.exe --off JohnDoe |
|
|
Upgrades a specified client to a reseller. Note: This command is available only for client accounts whose owner is Parallels Plesk Panel administrator. Available since Plesk 9.0. |
To upgrade the client with the login name JohnDoe to the reseller: >client.exe --convert-to-reseller JDoe or >client.exe -t JDoe |
|
|
Assigns a new owner for a client. Requires Available since Plesk 9.0. |
To change the owner of the JDoe client account to the reseller with the login name RichardRoe: >client.exe --change-owner JDoe -owner RichardRoe or >client.exe -co JDoe -owner RichardRoe |
|
|
Creates a Google Apps account with generated login and password for the specified client. |
To create a Google Apps account for the client with the login name JDoe: >client.exe --create-gapps-account JDoe |
|
|
Associates an existing Google Apps account with the specified client. Requires |
To associate a Google Apps account with the login name JohnDoe and password userpass with the client with the login name JDoe: >client.exe --link-gapps-account JDoe -gapps-login JohnDoe -gapps-passwd userpass |
|
|
Removes association of a Google Apps account with the specified client's account. |
To dissociate a Google Apps account from the client with the login name JDoe: >client.exe --unlink-gapps-account JDoe |
|
|
Removes a Google Apps account for the specified client. |
To remove a Google Apps account associated with the client with the login name JDoe: >client.exe --remove-gapps-account JDoe |
|
|
Displays help on the utility use. |
To view help on the utility: >client.exe --help or >client.exe -h |
Options
Option |
Parameter |
Description |
Example |
|---|---|---|---|
|
|
Enables/Disables a client account (the Disables a client account and sets the account status to "Account is disabled by administrator Is |
To disable the client account with the login name JDoe and assign status "Account is disabled by administrator" to the account: >client.exe -u JDoe -status admin,expired
To disable the client account with the login name JDoe and assign status "Account is disabled by reseller. Account is expired" to the account: >client.exe -u JDoe -status reseller,expired |
|
|
Specifies a client's company name. |
To set the company name in the personal info of the JohnDoe account to MegaCompany Inc.: >client.exe --update JohnDoe -company "MegaCompany Inc." |
|
|
Specifies a client's contact name. Required with |
See the Example above. |
|
|
Specifies a client's login name. Used with |
To change the account login name from JohnDoe to John: >client.exe --update JohnDoe -login John |
|
|
Specifies a client's password. Required with |
To create the account for the client John Doe with the login name JohnDoe and the password sample: >client.exe --create JohnDoe -name "John Doe" -passwd sample |
|
|
Specifies a client's phone number. |
To set the phone number in the personal info of the client with the login name JohnDoe to 5552345678: >client.exe --update JohnDoe -phone 5552345678 |
|
|
Specifies a client's fax number. |
To set the fax number in the personal info of the client with the login name JohnDoe to 5556676677: >client.exe --update JohnDoe -fax 5556676677 |
|
|
Specifies a client's email address. |
To set the email address in the personal info of the client with the login name JohnDoe to jd@example.com: >client.exe --update JohnDoe -email jd@example.com |
|
|
Specifies a client's postal address. |
To set the postal address in the personal info of the client with the login name JohnDoe to Elm str. 17: >client.exe --update JohnDoe -addr "Elm str. 17" |
|
|
Specifies a client's city. |
To set the city in the personal info of the client with the login name JohnDoe to New York: >client.exe --update JohnDoe -city "New York" |
|
|
Specifies a client's state/province. |
To set the state in the personal info of the of the client with the login name JohnDoe to NY: >client.exe --update JohnDoe -state NY |
|
|
Specifies a client's zip/postal code. |
To set the zip code in the personal info of the client with the login name JohnDoe to 77381: >client.exe --update JohnDoe -pcode 77381 |
|
|
Specifies a client's country: a two-letters upper-case code in compliance with ISO 3166. |
To set the country in the personal info of the client with the login name JohnDoe to United States: >client.exe --update JohnDoe -country US |
|
|
Enables/Disables sending a notification on a client account creation. Used with |
See the Example above. |
|
|
Specifies a client template to be used for a client creation. Used with the |
To specify the template Client Template to create the John Doe client account with the login name JDoe and password sample for the reseller with the login name RichardRoe: >client.exe -c JDoe -name "John Doe" -passwd sample -template "Client Template" -owner RichardRoe |
|
|
Forces the use of a client template to create a client account even if some of the template options cannot be implemented. Used only with the |
To force the use of the template Client Template to create the John Doe client account with the login name JDoe and password sample for Parallels Plesk Panel administrator: >client.exe -c JDoe -name "John Doe" -passwd sample -template "Client Template" -force |
|
|
Specifies whether the dedicated IIS application pool is provided for a client. Is |
To grant dedicated IIS application pool to the account with the login name JohnDoe: >client.exe --update JohnDoe -iis_app_pool true |
|
|
Limits a percent of CPU usage for a client's IIS application pool (in %). Used only if a client is provided with dedicated IIS application pool. Unlimited if set to |
To restrict the CPU usage for the dedicated IIS application pool of the account with the login name JohnDoe to 5%: >client.exe --update JohnDoe -iis_app_pool true -cpu_usage 5 |
|
|
Allows/Prohibits creating a corresponding user account in Sitebuilder. Is |
To allow client with the login name JDoe to create user account in Sitebuilder: >client.exe -u JDoe -sb-user true |
|
|
Specifies the client owner login name. Required with the Available since Parallels Plesk Panel 9.0. |
To create a client account named John Doe with the login name JDoe and password sample for the reseller RichardRoe: >client.exe -c JDoe -name "John Doe" -passwd sample -owner RichardRoe To change the owner of the JDoe client account to Parallels Plesk Panel administrator: >client.exe -co JDoe -owner admin |
|
|
Google Apps account login. Required with |
To associate a Google Apps account with the login name JohnDoe and password userpass with the client with the login name JDoe: >client.exe --link-gapps-account JDoe -gapps-login JohnDoe -gapps-passwd userpass |
|
|
Google Apps account password. Required with |