The client_pref utility enables the administrator to set and edit the client's limits and permissions, to manage the client's IP pool, and to define Plesk interface preferences (e.g. the default language and skin) for the client through CLI.
Syntax
client_pref <command> <client_login_name> [
<option_1> [<param>]
[<option_2> [<param>]]
… [<option_N> [<param>]]
Example
The following command updates the client account with the login name JDoe as follows: the client is allowed to manage log rotation and mailing lists and to create up to 20 subdomains. The use of disk space allotted for the client is restricted to 20 GB, and the expiration date of the client account is set to 2008-12-31.
# ./client_pref --update JDoe -manage_log true -manage_maillists true -max_subdom 20 -disk_space 20G -expiration 2008-12-31
Commands
Command |
Parameter |
Description |
Example |
|---|---|---|---|
|
|
Updates preferences and limits for an existing client account. |
To disable changing domain limits for the client account with the login name JDoe: # ./client_pref --update JDoe -change_limits false or # ./client_pref -u JDoe -change_limits false |
|
|
Displays the list of available control panel interface skins. |
To view the list of available interface skins: # ./client_pref --skin-list or # ./client_pref -sl |
|
|
Displays information about client account preferences and limits. |
To view information about preferences and limits set on the client account with login name JDoe: # ./client_pref --info JDoe or # ./client_pref -i JDoe |
|
|
Displays help on the use of the utility. |
To view help on the use of the # ./client_pref --help or # ./client_pref -h |
Options
Option |
Parameter |
Description |
Example |
|---|---|---|---|
|
|
Allows/Prohibits creation domains. Is |
To allow the client with the login name JDoe to create domains: # ./client_pref -u JDoe -create_domains true |
|
|
Allows/Prohibits managing physical hosting. Is |
To allow the client with the login name JDoe to manage physical hosting: # ./client_pref -u JDoe -manage_phosting true |
|
|
Allows/Prohibits managing PHP safe mode. Is Available since Plesk 8.1.1. |
To allow the client with login name JDoe to manage PHP safe mode: # ./client_pref -u JDoe -manage_php_safe_mode true |
|
|
Allows/Prohibits changing domain limits. Is |
To allow the client with the login name JDoe to change domain limits: # ./client_pref -u JDoe -change_limits true |
|
|
Allows/Prohibits managing DNS. Is |
To allow the client with the login name JDoe to manage DNS: # ./client_pref -u JDoe -manage_dns true |
|
|
Allows/Prohibits managing log rotation. Is |
To allow the client with the login name JDoe to manage log rotation: # ./client_pref -u JDoe -manage_log true |
|
|
Allows/Prohibits managing task scheduler. Is |
To allow the client with the login name JDoe to manage task scheduler: # ./client_pref -u JDoe -manage_crontab true |
|
|
Allows/Prohibits managing anonymous FTP. Is |
To allow the client with the login name JDoe to manage anonymous FTP: # ./client_pref -u JDoe -manage_anonftp true |
|
|
Allows/Prohibits managing Java applications. Is |
To allow the client with the login name JDoe to manage Java applications: # ./client_pref -u JDoe -manage_webapps true |
|
|
Allows/Prohibits managing mailing lists. Is |
To allow the client with the login name JDoe to manage mailing lists: # ./client_pref -u JDoe -manage_maillists true |
|
|
Allows/Prohibits managing system access. Is |
To allow the client with the login name JDoe to manage system access: # ./client_pref -u JDoe -manage_sh_access true |
|
|
Allows/Prohibits managing non-chrooted environment. Is |
To allow the client with the login name JDoe to manage non-chrooted environment: # ./client_pref -u JDoe -manage_not_chroot_shell true |
|
|
Allows/Prohibits managing subdomains. Is |
To allow the client with the login name JDoe to manage subdomains: # ./client_pref -u JDoe -manage_subdomains true |
|
|
Allows/Prohibits managing hard disk quota. Is |
To allow the client with login name JDoe to manage hard disk quota: # ./client_pref -u JDoe -manage_quota true |
|
|
Allows/Prohibits backing up and restoring data. Deprecated. Is |
To allow the client with the login name JDoe to backup and restore data: # ./client_pref -u JDoe -make_dumps true |
|
|
Allows/Prohibits backing up and restoring data using the Plesk repository. Is |
To allow the client with the login name JDoe to backup and restore data using the Plesk repository: # ./client_pref -u JDoe -allow_local_backups true |
|
|
Allows/Prohibits backing up and restoring data using the FTP repository. Is |
To allow the client with the login name JDoe to backup and restore data using the FTP repository: # ./client_pref -u JDoe -allow_ftp_backups true |
|
|
Allows/Prohibits managing Dr.Web antivirus application used on client's domains. Deprecated since Plesk 8.1.1. Use the |
To allow the client with the login name JDoe to manage the Dr.Web antivirus application: # ./client_pref -u JDoe -manage_drweb true |
|
|
Allows/Prohibits managing antivirus tool used on client's domains. Is |
To allow the client with the login name JDoe to manage antivirus tool: # ./client_pref -u JDoe -manage_virusfilter true |
|
|
Allows/Prohibits using Plesk API. Is |
To allow the client with the login name JDoe to use Plesk API: # ./client_pref -u JDoe -remote_access_interface true |
|
|
Allows/Prohibits managing domain aliases. Is |
To allow the client with the login name JDoe to manage domain aliases: # ./client_pref -u JDoe -manage_domain_aliases true |
|
|
Allows/Prohibits accessing Plesk GUI (as opposite to using Plesk API). Is |
To prohibit the client with login name JDoe from accessing Plesk GUI: # ./client_pref -u JDoe -cp_access false |
|
|
Allows/Prohibits managing desktop view. Can be set to Is |
To prohibit the client with login name JDoe from managing desktop view: # ./client_pref -u JDoe -manage_dashboard true |
|
|
Allows/Prohibits using standard view. Can be set to Is |
To prohibit the client with the login name JDoe from using standard view: # ./client_pref -u JDoe -stdgui false |
|
|
Allows/Prohibits managing spam filter. Is |
To allow the client with the login name JDoe to manage spam filter: # ./client_pref -u JDoe -manage_spamfilter true |
|
|
Allows/Prohibits managing web statistics. Is Available since Plesk 8.2. |
To allow the client with the login name JDoe to manage web statistics: # ./client_pref -u JDoe -manage_webstat true |
|
|
Limits the number of available domains. Unlimited if set to |
To restrict maximum number of domains available to the client with the login name JDoe to 10: # ./client_pref -u JDoe -max_dom 10 |
|
|
Limits the number of available domain aliases. Unlimited if set to |
To restrict the maximum number of domain aliases available to the client with the login name JDoe to 5: # ./client_pref -u JDoe -max_dom_aliases 5 |
|
|
Limits the amount of available disk space. A number without a letter is interpreted as the number of bytes. Unlimited if set to |
To restrict the maximum amount of disk space available to the client with the login name JDoe to 100 MB: # ./client_pref -u JDoe -disk_space 100M |
|
|
Limits the monthly traffic usage. A number without a letter is interpreted as the number of bytes. Unlimited if set to |
To restrict the maximum amount of traffic available to the client with the login name JDoe to 10 GB/month: # ./client_pref -u JDoe -max_traffic 10G |
|
|
Limits the number of available mailboxes. Unlimited if set to |
To restrict the maximum number of mailboxes available to the client with the login name JDoe to 100: # ./client_pref -u JDoe -max_box 100 |
|
|
Limits the amount of disk space that a single mailbox can occupy. A number without a letter is interpreted as the number of bytes. Unlimited if set to |
To set the mailbox quota for the client with login name JDoe to 10 MB: # ./client_pref -u JDoe -mbox_quota 10M |
|
|
Limits the number of available mail redirects. Unlimited if set to |
To restrict the maximum number of mail redirects available to the client with the login name JDoe to 10: # ./client_pref -u JDoe -max_redir 10 |
|
|
Limits the number of available mail groups. Unlimited if set to |
To set the number of mail groups available to the client with the login name JDoe to unlimited: # ./client_pref -u JDoe -max_mg -1 |
|
|
Limits the number of available mail autoresponders. Unlimited if set to |
To restrict the maximum number of mail autoresponders available to the client with the login name JDoe to 5: # ./client_pref -u JDoe -max_resp 5 |
|
|
Limits the number of available web users. Unlimited if set to |
To restrict the maximum number of web users available to the client with the login name JDoe to 50: # ./client_pref -u JDoe -max_wu 50 |
|
|
Limits the number of available mailing lists. Unlimited if set to |
To restrict the maximum number of mailing lists available to the client with the login name JDoe to 30: # ./client_pref -u JDoe -max_maillists 30 |
|
|
Limits the number of available databases. Unlimited if set to |
To restrict the maximum number of databases available to the client with the login name JDoe to 20: # ./client_pref -u JDoe -max_db 2 |
|
|
Limits the number of available Java applications. Unlimited if set to |
To restrict the maximum number of Java applications available to the client with the login name JDoe to 50: # ./client_pref -u JDoe -max_webapps 50 |
|
|
Limits the number of available subdomains. Unlimited if set to |
To restrict the maximum number of subdomains available to the client with the login name JDoe to 40: # ./client_pref -u JDoe -max_subdom 40 |
|
|
Limits the validity period of a client account. Unlimited if set to |
To set the validity period of the client account with the login name JDoe to February 29, 2008: # ./client_pref -u JDoe -expiration 2008-2-29 |
|
|
Adds/Deletes IP addresses to/from a client's IP address pool. |
To add IP addresses 192.0.2.78 and 192.0.2.89 to the IP address pool of the client account with login name JDoe: # ./client_pref -u JDoe -ip_pool add:192.0.2.78,192.0.2.89 |
|
|
Sets the default interface language for client's control panel interface. The argument of the command must be a valid four-letter language code derived from the language code described in ISO-639-2 and the corresponding country code described in ISO-3166. For example, the Plesk code for the Italian language code is |
To set the default interface language for the client with the login name JDoe to Russian: # ./client_pref -u JDoe -locale ru-RU |
|
|
Sets the default interface language for client's control panel interface. Deprecated since Plesk 8.0. Use the |
To set the default interface language for the client with the login name JDoe to Russian: # ./client_pref -u JDoe -language ru-RU |
|
|
Sets the default interface skin for a client's control panel interface. |
To set the skin WinXP Olivegreen as the default interface skin for the client with the login name JDoe: # ./client_pref -u JDoe -skin "WinXP Olivegreen" |
|
|
Allows/Prohibits having several simultaneous sessions under client's login. Is |
To prohibit multiple sessions to run simultaneously under login of the client with the login name JDoe: # ./client_pref -u JDoe -multiple-sessions false |
|
|
Limits button label length for the client's control panel interface. |
To restrict the maximum button label length for the control panel interface of the client with the login name JDoe to 10: # ./client_pref -u JDoe -max-button-length 10 |
|
|
Prevents/Allows working with Plesk until page is completely loaded. Is |
To prevent client with login name JDoe from working with the control panel until control panel screens are completely loaded: # ./client_pref -u JDoe -lock-screen true |
|
|
Sets the default desktop preset for client's control panel interface. |
To set the preset Custom Desktop as the default interface skin for the client with the login name JDoe: # ./client_pref -u JDoe -skin "Custom Desktop" |