This chapter describes the version-specific changes in the command-line utilities. The changes are grouped by new features. To describe a particular change in CLI, we use the following notations:
Reassignment of databases between subscriptions
database
utility:New command: --assign-to-subscription
.
Database user roles and privileges management
database
utility:New options: -user-role
, -set-privileges
.
PHP handlers management
php_handler
utility:New commands: --enable
, --disable
, --get-usage
.
Listing mail accounts
mail
utility:New command: --list
.
Setting an end date for auto-replies
autoresponder
utility:New option: -end-date
.
Displaying global server settings
server_pref
utility:New command: --show
.
SSL ciphers and protocols management
server_pref
utility:New options: -ssl-protocols
, -ssl-ciphers
.
Managing server-wide backup limits
server_pref
utility:New options: -max-backup-files
, -keep-local-backup
.
Disabling automatic upgrading of extensions
server_pref
utility:New option: -disable-upgrade-extensions
.
Enabling and disabling Fail2ban
ip_ban
utility:New commands: --enable
, --disable
.
Retrieving new license keys from KA
license
utility:New command: --retrieve
.
Managing Plesk locales
locales
utility.Installing and upgrading extensions via URL
extension
utility:New command: --install-url
.
Apache MPM mode management
optimization_settings
utility.Setting PHP-FPM in service plan setting
service_plan
utility:New option: -php_served_by_nginx
.
Security status of WordPress installations
wp_instance
utility:New command: --get-security-status
.
Enabling password protection fro site preview
server_pref
utilityNew options: -preview-protection
WordPress toolkit
wp_instance
utility.php_handler
utility:New option: -clipath
.
IP address banning (Fail2Ban)
ip_ban
utility.
Web application firewall (ModSecurity)
subscription
utility:New commands: --update-web-app-firewall
, --show-web-app-firewall
.
New option: -waf-rule-engine
.
server_pref
utility:New commands: --update-web-app-firewall
, --show-web-app-firewall
.
New options: -waf-rule-engine
, -waf-rule-set
.
Outgoing mail control
mailserver
utility:New commands: --enable-outgoing-antispam, --disable-outgoing-antispam, --set-outgoing-messages-mbox-limit
, --set-outgoing-messages-domain-limit
, --set-outgoing-messages-subscription-limit
, --set-outgoing-messages-enable-sendmail
, --set-outgoing- messages-report-period
, --set-outgoing-messages-notification-period
.
New option: -spf-ignore-dns-error
.
service_plan
and subscription_settings
utilities:New options: -outgoing-messages-mbox-limit
, -outgoing-messages-domain-limit
, -outgoing-messages-subscription-limit
, -outgoing-messages-enable-sendmail
.
mail
utility:New option: -outgoing-messages-mbox-limit
.
site
utility:New option: -outgoing-messages-domain-limit
.
IP addresses to send mail from
mailserver
utility:New command: --set-outgoing-email-mode
.
New options: -explicit-ipv4
, -explicit-ipv6
.
Prohibited domain names
domain_restriction
utility.
Access control lists for MySQL database users
subscription_settings
utility: New option: -remote_db_connection
.
database
utility: New option: -set-acl
, -add-access
, -remove-access
.
Remote access for PostgreSQL database users
database
utility: New option: -allow-access-from
.
Automated migration and transfer of a large number of objects
migrate
utility.
Converting reseller accounts to customer accounts
reseller
utility:New command: --convert-to-customer
.
Moving customer accounts to another owner
customer
utility:New command: --change-owner.
Converting customer accounts to reseller accounts
customer
utility:New command: --convert-to-reseller
.
Custom descriptions of Plesk objects
reseller
, customer
, and mail
utilities:New option: -description
.
site
utility:New options: -description
, -admin-description
.
subscription
utility:New options: -description
, -reseller-description
, -admin-description
.
Preventing customers from using a Plesk server as an FTP storage for Plesk backups
server_pref
utility:New command: --allow-local-ftp-backup
.
Database users’ access to databases
database
utility: New options: -database
, -any-database
.
Clearance of APS applications cache
aps
utility:New command: --clear-cache
.
Restoring selected objects from a backup
pleskrestore
utility:New options: -only-mailnames
, -only-databases
, -only-web-content
, -only-sites
, -domain-name
.
subscription
utility: New command: --update-web-server-settings
.
New options: -apache-mime-types
, -apache-handlers
, –ip-deny
, -ip-allow
, -apache-directory-index
, -nginx-transparent-mode
, -nginx-serve-static
, -nginx-static-extensions
, -nginx-serve-php
.
Status of websites in suspended subscriptions
subscription
, service_plan
utilities: New option: -unpaid-website-status
.
External SMTP server for Plesk notifications and outgoing mail generated by scripts
mailserver
utility:New command: --update-smtp-settings
.
New options: -smtp-host
, -smtp-port
, -smtp-login
, -smtp-password
, -mail-notifications
, -smtp-tls
, -smtp-allow-users
.
APS applications settings
aps
utility:New options: -db-server
, -prefix
, -aps-force-updates
.
Restricting the list of applications available for installation
customer
utility:New commands: --add-aps-filter-item
, --remove-aps-filter-item
, --enable-aps-filter
, --disable-aps-filter
, --show-aps-filter-info
.
New options: -aps-filter-item-name
, -aps-filter-item-value
.
serice_plan_addon
utility:New commands: --add-aps-filter-item
, --remove-aps-filter-item
, --show-aps-filter-info
.
New options: -aps-filter-item-name
, -aps-filter-item-value
.
Search engine friendly redirection and forwarding
subscription
, subdomain
, site
, and domalias
utilities: New option: -seo-redirect
.
subscription
, site
utilities: New option: -http_code
.
Multiple PHP versions
service_plan
, service_plan_addon
, subscription
, subdomain
, and site
utilities: New option: -php_handler_id
.
Deprecated option: -php_handler_type
.
Custom PHP handlers
php_handler
utility.
Mail autoresponder settings
autoresponder
utility:New option: -frq
.
Plesk Administrator account settings
admin
utility:New commands: --set-admin-password, --set-password
.
New options: -passwd
, -encrypted-password
, -plain-password
, -remote_access_interface
, -manage_server_mailgate
, -manage_secure_passwords
.
Additional Administrator accounts
admin_alias
utility
One database user to access all databases
database
utility:New commands: --create-dbuser
, --update-dbuser
, --remove-dbuser
.
The default database server
service_plan
, subscription_settings
utilities: New options: -default_server_mysql
, -default_server_postgresql
.
Creating auxiliary users while creating mail accounts
mail
utility: New option: -cp-access
.
Specifying mail accounts and instant messengers for auxiliary users
user
utility:New options: -email
, -external-email
, -im-type
, -im
.
Plesk UI appearance and branding
branding_theme
utility: New commands: --set
, --list
.
New option: -name
.
panel_gui
utility: New options: ---billing_enabled
.
Websites maintenance mode
subscription
, site
, subdomain
utilities: Deprecated option: -maintenance-mode
. The Suspended website status is used instead (see the next change).
The Suspended status of websites
subscription
, site
, subdomain
utilities: New command: --suspend
.
Loading Plesk settings from Partner Central
server_pref
utility: New command: --load-customizations
.
Server-wide Plesk settings
server_pref
utility: New options: -aps-force-updates
, -aps-suggest-updates
, -apache-pipelog
, -forbid-ftp-user-rename
, -forbid-subscription-rename
, -ftp-over-ssl
, -autoupdates-third-party
.
Server cloning settings
cloning
utility: New options: --reset-init-conf
, -skip-update
.
Access to Control Panel for resellers
reseller_plan
utility: Deprecated option: -cp-access
.
Making copies of service plans, add-on plans, and reseller plans
service_plan
, service_plan_addon
, reseller_plan
utilities: New command: --duplicate
.
New option: -duplicate-name
.
Domains and domain aliases settings
subscription
, subdomain
, site
, and domalias
utilities: New options: -notify
, -max-connections
, -traffic-bandwidth
.
Displaying customers and subscriptions in a list
customer
, subscription
utilities:New command: --list
.
Installing the Plesk license key with an activation code
license
utility: --install
command now accepts activation codes.
Managing Plesk extensions
extension
utility.
Improved Plesk security
server_pref
utility.-min_password_strength
.
Cloning Plesk in virtual environments
cloning
utility.
Custom buttons improvements
custombutton
utility:-place
option: admin-settings
, reseller-settings
.-noframe
.custom_plan_items
utility:-noframe
.
Plesk updates improvements
product_info
utility:--updates-info
.
Subscribing to security notifications from Plesk
init_conf
utility:-send_tech_announce
.
Using license bundles (web app licenses associated with a Plesk license)
service_plan
, service_plan_addon
, reseller_plan
, subscription_settings
utilities:-allow_license_stubs
.Customizable PHP configuration
service_plan, service_plan_addon, subscription, subscription_settings, site
utilities: --update-php-settings, --show-php-settings
-settings, -additional-settings
Extended overuse options
service_plan, subscription_settings, reseller_pref, reseller_plan
utilities: not_suspend_notify
Custom view for administrators
poweruser
utility: -simple, -lock
admin
utility:
Restricting users to access only one subscription
user
utility: -subscription-name, -for-all-subscriptions
Support for wildcard subdomains
subdomain
utility: -create
command allows to use the asterisk symbol to create wildcard subdomains.
Quick preview of a website
server_pref
utility: -preview-domain
Manage availability of apps from Storefront
server_pref
utility: -show-commercial-apps
Allowing Subdomains to Have Own DNS Zones
server_pref
utility: -subdomain-dns-zone
Updating Business Manager administrator's profile
update-admin
utility.Updating Business Manager company settings
update-company
utility.Managing Business Manager database connection
billing-db
utility.Migrating a standalone Plesk Billing database to Business Manager
migrate-db
utility.Getting Business Manager error information
get-error-report
utility.Troubleshooting GUI Integration between Business Manager and connected Plesks
integration
utility.Updating Business Manager configuration and online stores locales and appearance
cache
utility.Allowing Subdomains to Have Own DNS Zones
server_pref
utility: -subdomain-dns-zone
File sharing functionality
server_filesharing
utility.role
utility: -publishFilesOnTheWeb
IPv6 support
dns
and server-dns
utilities:New option: -aaaa
subscription
utility: -ip
option can be used multiple times to specify a list of IPV4 and IPv6 addresses addresses.reseller_plan
utlity:New option: -excl_ipv6_num
Server Name Indication (SNI) support
domain
and subdomain
utilities:New option: -certificate-name
Note: The following operating systems support SNI: OpenSuSE Linux 11.3 or later, Ubuntu Linux 10.4 or later, Debian Linux 6.0 or later, and RedHat Linux 6.0 or later.For more information on SNI see section Hosting Multiple SSL Sites on a Single IP Address (Linux Hosting) of Administrator's Guide.
Encrypting the administrator's password
admin
utility:New command: --show-password
Ability to customize the list of applications available for installation on websites and add links to additional services (external or integrated with Plesk as extensions)
subscription
utility replaces the domain
utility and supports new commands and options.New commands: --enable-aps-filter, --add-aps-filter-item, --remove-aps-filter-item, --disable-aps-filter, --show-aps-filter-info, --add-custom-plan-item, --remove-custom-plan-item, --remove-all-custom-plan-items, --show-custom-plan-items
New options: -aps-filter-item-name, -aps-filter-item-value, -aps-filter-type, -custom-plan-item-name
custom_plan_items
utility.service_plan
utility:New commands: -enable-aps-filter, --add-aps-filter-item, --remove-aps-filter-item, --disable-aps-filter, --show-aps-filter-info, --add-custom-plan-item, --remove-custom-plan-item, --remove-all-custom-plan-items, --show-custom-plan-items
New options: -aps-filter-item-name, -aps-filter-item-value, -aps-filter-type, -custom-plan-item-name
reseller
utility:New commands: -enable-aps-filter, --add-aps-filter-item, --remove-aps-filter-item, --disable-aps-filter, --show-aps-filter-info
New options: -aps-filter-item-name, -aps-filter-item-value, -aps-filter-type
reseller_plan
utility replaces the reseller-template
utility and supports the following new commands and options.New commands: -enable-aps-filter, --add-aps-filter-item, --remove-aps-filter-item, --disable-aps-filter, --show-aps-filter-info
New options: -aps-filter-item-name, -aps-filter-item-value, -aps-filter-type
Customization of interface appearance and branding settings
branding_theme
utilitypanel_gui
utility replaces the interface-template
utility and supports the following new options: -domain_registration_url
, -domain_management_url
, -cert_purchasing_url
, -mpc_portal_url
Site maintenance mode
subscription
utility: new option -maintenance-mode
.subdomain
utility: new option -maintenance-mode
.Ability to create trial sites in SiteBuilder
service_plan
utility: new option -upsell_site_builder
.Ability to register an external webmail service with Plesk and use it in hosting plans
mailserver
utility:New commands: --add-external-webmail
, --update-external-webmail
, --remove-external-webmail
.
New options: -webmail-name
, -webmail-url
, -webmail-status
.
Ability to hide mail management functions from Control Panel
server_pref
utility: new option -disable-mail-ui
.Ability to set the default shell for execution of scheduled tasks through cron
server_pref
utility: new option -crontab-secure-shell
.Utilities were renamed to better suit the new hosting model
client
utility was replaced with the customer
utility.domain
utility was replaced with the subscription
and site
utilities.domain_prefs
utility was replaced with the subscription_settings
utility.domain_template
utility was replaced with the service_plan
utility.interface_template
utility was replaced with the panel_gui
utility.reseller-template
utility was replaced with the reseller_plan
utility.domain_addon_service_plan
utility was replaced with the service_plan_addon
utility.Changes in the hosting model and hierarchy of user accounts
client_template
utility.client
utility: the commands --convert-to-reseller
and --change-owner
are no longer supported; the options -template
, -sb-user
, -status
, and -force
are no longer supported.client_pref
utility: the command --set-iis-app-pool-settings
and options -iis-app-pool-turned-on
, -cpu-usage-state
, -cpu-usage-value
were added; the options -manage dashboard
, -max-mg
, -desktop-preset
, -max_redir
, -max_resp
, -lock-screen
, -desktop-preset
are no longer supported.domadmin
utility.domuser
utility.domain
utility: the commands --webspace-status
, --lock-subscription
, --unlock-subscription
, --no-subscription
, --switch-subscription
, --sync-subscription
, --add-subscription
, --remove-subscription
were added; the options -service-plan
, -force-lock
, -www-root
, -webspace-name
, -vendor
were added.domain_addon_service_plan
utility.domain_pref
utility. The following options were removed: -max_redir
, -max_mg
, -max_resp
.The following options were added: -max_site
, -max_subftp_users
, -max_site_builder
, -max_unity_mobile_sites
, -create_domains
, -manage_phosting
, -manage_php_safe_mode
, -manage_performance
, -manage_sh_access
, -manage_quota
, -manage_subdomains
, -manage_domain_aliases
, -manage_log
, -manage_anonftp
, -manage_subftp
, -manage_crontab
, -manage_dns
, -manage_webapps
, -manage_maillists
, -manage_spamfilter
, -manage_virusfilter
, -manage_webstat
, -select_db_server
, -allow_local_backups
, -allow_ftp_backups
, -access_appcatalog
, -allow_insecure_sites
.
The option -overuse
can now take the new parameter not_suspend
.
domain_service_plan
utility is intended to replace the utility domain_template
.In addition to the options previously supported by the domain_template
utility, the following new options are now supported: -max_site
, -max_subftp_users
, -max_site_builder
, -max_unity_mobile_sites
, -create_domains
, -manage_phosting
, -manage_php_safe_mode
, -manage_performance
, -manage_sh_access
, -manage_quota
, -manage_subdomains
, -manage_domain_aliases
, -manage_log
, -manage_anonftp
, -manage_subftp
, -manage_crontab
, -manage_dns
, -manage_webapps
, -manage_maillists
, -manage_spamfilter
, -manage_virusfilter
, -manage_webstat
, -select_db_server
, -allow_local_backups
, -allow_ftp_backups
, -access_appcatalog
, -allow_insecure_sites
.
The option -overuse
can now take the new parameter not_suspend
.
ip_pool
utility: It now supports only operations on IP addresses assigned to resellers; customers are assigned IP addresses in a different manner, only when hosting subscriptions are created for them.mail
utility - the following options were removed: -cp-access
, -multiple-sessions
, -locale
, -lines-per-page
, -max-button-length
, -skin
, -lock-screen
. The option -forwarding-addresses
was added.reseller
utility. The following commands are now supported: --lock-subscription
, --unlock-subscription
, --no-subscription
, --switch-subscription
, --sync-subscription
.The following new options are now supported: -service-plan
, -force-lock
.
The following commands and options are no longer supported: --convert-to-client
, -sb-user
, -template
.
-access_appcatalog
, -allow_insecure_sites
, -max_site_builder
, -max_subftp_users
, -max_unity_mobile_sites
.The following options are no longer supported: -manage_dashboard
, -dashboard
, -stdgui
, -expiration
, -max-redir
, -max-mg
, -max-resp
.
reseller_service_plan
utility is intended to replace the utility reseller_template
.In addition to the options previously supported by the reseller_template
utility, the following new options are now supported: -max_subftp_users
, -max_site_builder
, -max_unity_mobile_sites
, -allow_insecure_sites
.
The option -overuse
can now take the new parameter not_suspend
.
The following options are no longer supported: -manage_dashboard
, -dashboard
, -stdgui
, -expiration
.
role
utility.user
utility.subdomain
utility: the new option -www-root
is now supported; the following options are no longer supported: -ftp_user
, -hard_quota
, -sb_publish
, -hst_type
.
VPS-optimized mode
vps_optimized
utility.Power User interface
poweruser
utility.User interface customization
interface_template
utility: the options -hide_disabled
, -hide_unavailable_limits
, -hide_unavailable_permissions
are no longer supported. Additional FTP accounts
ftpsubaccount
utilityclient_pref
utility: -max-subftp-users
optionclient_pref
utility: -manage_subftp
optiondomadmin
utility: -manage_subftp
optiondomain_pref
utility: -max-subftp-users
optiondomain_template
utility: -max-subftp-users
optionreseller_pref
utility: -max-subftp-users
optionreseller_pref
utility: -manage_subftp
optionreseller_template
utility: -max-subftp-users
optionreseller_template
utility: -manage_subftp
optionChanges in Application Catalog
aps_catalog
utilityaps
utilityChanges in settings of mail services
autoresponder
utility: the commands --create
, --remove
, --attachments
, --on
, --off
are no longer supported; the options -requires
, -replyto
, -frq
, -store
, - redirect
, -files
are no longer supported.domain_pref
utility - the following options were removed: -max_redir
, -max_mg
, -max_resp
.spamassassin
utility: new parameter -action move
.E-mail notification about system events
notification
utility.(+) new options related to integration with Google Services for Websites were added to the admin, reseller, client, and server_pref utilities.
Greylisting
(+) grey_listing utility
APS Catalog
aps-catalog
utilityPlesk resellers
client
utility: --change-owner
commandclient
utility: --convert-to-reseller
commandclient
utility: -owner
optionclient_pref
utility: -ip_pool
optionclient_pref
utility: -overuse
optiondomain
utility: --change-owner
commanddomain
utility: -clogin
optiondomain
utility: --create
commanddomain_pref
: -overuse
optionip_pool
utilityreseller
utilityreseller_pref
utilityreseller_template
utilityNew utilities
event_handler
utilitykeyinfo
utilityUpdates of existing utilities:
client_pref
utility: -ip_pool
optioncustombutton
utility: --list
commanddomain_template
utility-fp
option-fp_ssl
option-fpauth
option-miva
optiondomain
utility-fplogin
option-fppasswd
optionPermission to choose a database server for a database
client_pref
utility: -select_db_server
optionclient_template
utility: -select-db-server
optiondomadmin
utility: -select_db_server
optionDomainKeys support
domain_pref
utility: -sign_outgoing_mail
optionmailserver
utility: --sign-outgoing-mail
commandmailserver
utility: --verify-incoming-mail
commandPermission to create DNS subzones in DNS superzones owned by other Plesk users
server_pref
utility: -forbid-create-dns-subzone
optionLimit on maximum number of available connections
domain
utility: -max-connections
optionOpportunity to publish sites with Sitebuilder
domain
utility: -publish-sb-site
optionLimit on network use
domain
utility: -traffic-bandwidth
optionThe <webuser_name>@<domain_name>
format of access to Plesk
domain_pref
utility: -at-access
optionSSO service
sso
utilitySite applications and site application licenses management
siteapp
utility: --add-to-vault
commandUse siteapp-item
utility instead.
siteapp
utility: -release
optionUse -sapp-release
option instead.
siteapp
utility: -sapp
optionUse -sapp-name
option instead.
siteapp
utility: -version
optionUse -sapp-version
option instead.
siteapp
utility: -sapp-name
optionsiteapp
utility: -sapp-release
optionsiteapp
utility: -sapp-version
optionsiteapp-item
utilitysiteapp-license
utility