site.exe: Sites
The site.exe
utility is used for managing sites within an existing webspace.
Note: For information on how to create and manage webspaces, refer to the Subscriptions: subscription Utility section.
Location
%plesk_cli%
Usage
site.exe <command> [<domain name>] [
<option 1> <param> [<option 2> <param>] ... [<option N> <param>]
]
Example
The following command sets up a new domain example.com in the testdomain.tst webspace.
site.exe --create example.com -webspace-name testdomain.tst
Commands
Command | Parameter | Description | Example |
---|---|---|---|
|
|
Creates a new domain inside an existing webspace.
Requires the -webspace-name option. |
To add a site example.com inside the testdomain.tst webspace: site.exe --create example.com -webspace-name testdomain.tst or site.exe -c example.com -webspace-name testdomain.tst |
|
|
Updates properties of an existing domain. |
To limit the amount of disk space that example.com can occupy to 200 MB: site.exe --update example.com -hard_quota 200M or site.exe -u example.com -hard_quota 200M |
|
|
Removes a domain. |
To remove example.com: site.exe --remove example.com or site.exe -r example.com |
|
|
Retrieves domain info. |
To retrieve information about example.com: site.exe --info example.com or site.exe --i example.com |
|
|
Enables a domain. |
To enable example.com: site.exe --on example.com |
|
|
Disables a domain. |
To disable example.com: site.exe --off example.com |
|
|
Sets IIS application pool settings for the specified domain name. The following settings can be specified:
This turns IIS application pool on or off.
This turns on or off monitoring of CPU usage by IIS application pool.
This sets the maximum allowed CPU usage rate for IIS application pool.
This sets the action that IIS takes when worker processes exceed the CPU usage limit.
This sets the reset interval - the period of time when the CPU monitoring data is reset. |
To switch on IIS application pool for the domain example.com and limit CPU usage to 5 percent: site.exe --set-iis-app-pool-settings example.com -iis-app-pool-turned-on true -cpu-usage-state true -cpu-usage-value 5 |
|
|
Updates custom PHP configuration for a website. Use the utility to set values for 16 most often used PHP settings (exposed to the Plesk GUI) or to add any additional PHP directive. |
To set one of 16 general PHP settings, prepare the file with the settings you want to change. Note: File syntax should be the same with Then apply the settings to the site (example.com): site.exe --update-php-settings example.com -settings my_file
If you cannot find a certain PHP parameter among 16 general settings, add it as an additional directive to a file and apply the changes to the site (example.com): site.exe --update-php-settings example.com -additional-settings my_file_add |
|
|
Displays information about current PHP configuration of a website. |
To view the PHP configuration information for the website example.com: site.exe --show-php-settings example.com |
|
|
Suspends the specified domain. |
To suspend the website example.com: >subscription.exe --suspend example.com |
|
|
Displays help on the use of the utility. |
To output the help info on the use of this utility: site.exe --help or site.exe -h |
Options
Option | Parameter | Description | Example |
---|---|---|---|
|
|
Renames a specified domain. |
To rename the domain from example.com to sample.com: site.exe --update example.com -new_name sample.com |
|
|
Enables/Disables DNS zone. By default, settings from the current server-wide DNS template are used. |
To enable the DNS zone for example.com: site.exe -u example.com -dns true |
|
|
Allows/Prohibits accessing the domain using URL with the www prefix. Is |
To remove the www prefix from example.com: site.exe --update example.com -www false |
|
|
Enables/Disables hosting. Is |
To enable hosting for the domain example.com: site.exe --update example.com -hosting true |
|
|
Sets up the type of hosting. Here, Default value is |
To set up standard forwarding hosting on the domain example.com: site.exe --update example.com -hst_type std -login john |
|
|
Sets the target URL for forwarding hosting types. Required if the |
To set up standard forwarding to the target URL sample.com for the domain example.com: site.exe --update example.com -hst_type std -target_url www.sample.com |
|
|
Sets the IP address for the mail service for the specified domain. |
Set the IP address for the mail service for the domain example.com to 192.168.1.2: site.exe -u example.com -mail-service-ip 192.168.1.2 |
|
|
Specifies the HTTP response status code to be used for standard forwarding. |
To use the 302 code for forwarding on the domain example.com, which has the standard forwarding type of hosting: site.exe -u example.com -http_code 302 |
|
|
Turns on the search engine friendly HTTP 301 redirection. Use ' |
To turn on redirection for the domain example.com to www.example.com: site.exe -u example.com -seo-redirect www |
|
<path> |
Specifies website home directory (relative to the webspace root). |
To set up a website example.com within the directory site2 in the webspace: site.exe -c example.com -service-plan megaplan -www-root site2 |
|
|
Specifies the webspace name (the same as the name of the main domain in the webspace). |
To create a domain site2.com inside an existing webspace example.com for the customer with the username JDoe: site.exe -c site2.com -webspace-name example.com owner JDoe |
|
|
Specifies the parent domain name when creating a subdomain.
|
To create a subdomain test.example.com for the parent domain example.com: site.exe -c test.example.com -parent-domain-name example.com
|
|
|||
|
|
Use for specifying the subdomains to be removed or to retrieve subdomain information ( |
To remove subdomains test1.example.com and test2.example.com: >subscription.exe -r -s test1.example.com,test2.example.com |
|
|
Sets the domain creation date. Used with the |
To set the creation date for domain example.com to 2009-12-30: site.exe -c example.com -creation-date 2008-12-30 |
|
|
Enables/Disables the mailing list service. Is |
To enable mailing list service on the domain example.com: site.exe -u example.com -maillist_service true |
|
|
Limits the number of available connections. Unlimited is set to |
To limit the maximum number of connections available for the domain example.com to 10: site.exe -u example.com -max-connections 10 |
|
|
Limits the network use. Unlimited is set to |
To limit the maximum network use on the domain example.com to 500 KB/S: site.exe -u example.com -traffic-bandwidth 500 |
|
|
Enables/Disables access to the system via remote desktop panel (RDP). Is |
To enable access to the system via RDP: site.exe --update example.com -shell "Login Enabled" |
|
< |
Sets the maximum amount of disk space available for the domain files. Unlimited if set to |
To set the 100 MB disk quota for example.com: site.exe --update example.com -hard_quota 100M |
|
|
Enables/Disables the creation and publishing of an empty site by Presence Builder when creating a new domain for the client with SB support. Is |
Not to create and publish an empty site when updating example.com: site.exe -u example.com -publish-sb-site false |
|
|
Enables/Disables SSI support. Is |
To enable SSI support on example.com: site.exe --update example.com -ssi true |
|
|
Enables/Disables SSI support for HTML and HTM files. Is |
To enable SSI support for HTML and HTM files on example.com: site.exe -u example.com -ssi_html true |
|
|
Enables/Disables PHP support. Is |
To enable PHP support on example.com: site.exe --update example.com -php true |
|
|
Associates the specified PHP handler with the specified website. Specify the handler's identifier ( |
To enable running PHP of version 5 as ISAPI extension on example.com: site.exe -u example.com -php_handler_id isapi-5 |
|
|
Enables/Disables CGI support. Is |
To enable CGI support on example.com: site.exe --update example.com -cgi true |
|
|
Determines the location of the cgi-bin directory. |
To set the location of the site.exe -u example.com -cgi-mode www-root |
|
|
Enables/Disables Perl support. Is |
To enable Perl support on example.com: site.exe --update example.com -perl true |
|
|
Enables/Disables ASP support. Is |
To enable ASP support on example.com: site.exe --update example.com -asp true |
|
|
Enables/Disables Python support. Is |
To enable Python support on example.com: site.exe --update example.com -python true |
|
|
Enables/Disables Miva support. Is |
To enable Miva support on example.com: site.exe --update example.com -miva true |
|
|
Enables/Disables accessing a domain via SSL. Is |
To enable SSL support on example.com: site.exe --update example.com -ssl true |
|
|
Sets up which web statistics tool should be used on a domain. Is |
To set Webalizer used on example.com: site.exe --update example.com -webstat webalizer |
|
|
Enables/Disables access to web statistics data through password- protected directory Is |
To enable access to web statistics data through password- protected directory site.exe -u example.com -webstat-protdir-access true |
|
|
Allows/Prohibits using custom HTTP error messages on a domain. Is |
To allow custom error documents on example.com: site.exe --update example.com -err_docs true |
|
|
Enables/Disables log rotation. Is |
To enable log rotation on the domain example.com: site.exe -u example.com -log-rotate true |
|
|
Enables/Disables log rotation based on the current log file size. |
To enable log rotation on the domain example.com once the current log file reaches the 200 KB size: site.exe -u example.com -log-bysize 200 |
|
|
Enables/Disables log rotation by time. Is |
To enable weekly log rotation on the domain example.com: site.exe -u example.com -log-bytime weekly |
|
|
Limits the number of log files parameter. Is |
To restrict the maximum number of log files (current and rotated) on the domain example.com to 10: site.exe -u example.com |
|
|
Enables/Disables log file compression. Is |
To disable log file compression on the domain example.com: site.exe -u example.com -log-compress false |
|
|
Enables/Disables automatic sending of rotated log files to the specified email address. |
To enable automatic sending of rotated log files on the domain example.com to email address admin@example.com: site.exe -u example.com -log-email admin@example.com |
|
|
Allows or prohibits granting the Plesk IIS user and IIS application pool user the full access permission for the domain’s This permission might be required for correct functioning of web applications. Note that this permission, when granted, might seriously compromise website security. Is |
To allow the Plesk IIS User and IIS application pool user to write and modify files and subfolders in site.exe --update example.com -write_modify true |
|
|
Allows or prohibits web deploy publishing. Is |
To enable web deploy publishing for example.com: site.exe --update example.com -webdeploy true |
|
|
Allows or prohibits using dedicated IIS application pool for a domain. Is used with the Is |
To allow using dedicated IIS application pool on example.com: site.exe --update example.com -iis_app_pool true |
|
|
Defines the maximum CPU usage by a domain (in percent). Is used with the |
To limit the maximum CPU usage by example.com to 3%: site.exe --update example.com -cpu_usage 3 |
|
|
Switches IIS application pool CPU usage monitoring on or off. |
To set up CPU usage settings for the IIS application pool of the domain example.com: site.exe --set-iis-app-pool-settings example.com -iis-app-pool-turned-on true -cpu-usage-state true -cpu-usage-value 3 -cpu-usage-action KillW3wp -cpu-usage-interval 5 -max-worker-processes 3 -idle-timeout 5 -managed-pipeline-mode Integrated -recycling-by-time 60 -recycling-by-requests 1000 -recycling-by-virtual-memory 5120 -recycling-by-private-memory 10240
|
|
|
Specifies the maximum percentage of CPU time that worker processes in an application pool are allowed to consume over a period of time specified by the If the limit is exceeded, the event is written to the event log and an optional set of events can be triggered. These optional events are determined by the |
|
|
|
Specifies the action that IIS takes when worker processes exceed the limit on CPU time usage.
|
|
|
|
Specifies the reset interval for monitoring of CPU usage by worker processes. |
|
|
|
Turns IIS application pool for a site on or off. |
|
|
|
The maximum number of worker processes permitted to service requests for IIS application pool. |
|
|
|
The amount of time a worker process will remain idle before it shuts down. |
|
|
|
Configures ASP.NET to run in classic mode as an ISAPI extension or in integrated mode where managed code is integrated into the request-processing pipeline. |
|
|
|
The period of time after which IIS application pool recycles. |
|
|
|
The maximum number of requests IIS application pool can process before it recycles. |
|
|
|
The maximum amount of virtual memory a worker process can consume before causing the IIS application pool to recycle. |
|
|
|
The maximum amount of private memory a worker process can consume before causing the IIS application pool to recycle. |
|
|
|
Enables/Disables log rotation. Is |
To disable log rotation on example.com: site.exe --update example.com -log_rotate false |
|
< |
Enables/Disables the processing of log files by size (the processing starts once the specified size is achieved). |
To enable the processing of example.com log files when their size comes up to 200 KB: site.exe --update sampledomain.com -log_bysize 200K |
|
|
Enables the processing of log files by time. Is |
To set up weekly log rotation on example.com: site.exe --update example.com -log_bytime weekly |
|
|
Specifies the maximum number of stored log files. Is |
To set the maximum number of log files on example.com to 5: site.exe --update example.com -log_max_num 5 |
|
|
Enables/Disables log file compression. Is |
To disable log file compression on example.com: site.exe --update example.com -log_compress false |
|
|
Enables sending log files to the specified email address. |
To enable sending the log file of example.com to JohnDoe@example.com: site.exe --update example.com -log_email JohnDoe@example.com |
|
|
Enables/Disables running mail service. Is |
To disable mail service on example.com: site.exe --update example.com -mail_service false |
|
|
Specifies the IP address of the service node providing the mail service or the domain. |
To set the IP address of the service node providing the mail service for the domain example.com to 192.168.1.2: site.exe -u example.com -mail_service_node 192.168.1.2 |
|
|
Enables/Disables sending the ‘domain created’ notification to Plesk administrator. Is |
To disable sending the notification: site.exe --create example.com -notify false |
|
|
Specifies the IP address to be assigned to the subscription after the subscription owner change. |
To assign the IP address 192.168.1.2 to the subscription example.com after the ownership change: site.exe -u example.com -map_ip 192.168.1.2 |
|
|
Allows/Prohibits publishing site with Presence Builder. Is |
To allow publishing site with Presence Builder on the domain example.com: site.exe -u example.com -publish-sb-site true |
|
|
Enables/Disables supporting Microsoft ASP.NET framework. Is |
To enable Microsoft ASP.NET framework support on example.com: site.exe -u example.com -asp.net true |
|
|
Sets the default version of Microsoft ASP.NET framework. Is 2 |
To make .NET v.2.0.x default on example.com: site.exe -u example.com -asp.net_version 2.0 |
|
|
Sets the SSL certificate for the site. |
To set the SSL certificate testcert for the domain example.com: site.exe -u example.com -certificate-name testcert |
|
|
Specifies a description of the subscription to be displayed in Plesk. |
To create a description of the domain example.com: site.exe -u example.com -description "Notes about this site" |
|
|
Specifies a description of the subscription for the administrator. It is displayed in Plesk only to the administrator. |
To create a description of the domain example.com that will be visible for the administrator only: site.exe -u example.com -description "Admin's notes about this site" |
|
|
Specifies a description of a subscription owned by a reseller. It is displayed in Plesk to the reseller and administrator. |
To create a description of the domain example.com that will be visible to the reseller and the administrator: site.exe -u example.com -reseller-description "Reseller's notes about this site" |
|
|
Sets the file containing custom PHP settings for a site. The file can include only 16 general PHP settings exposed to the Plesk GUI. Used with |
To set custom PHP configuration from the file my_file to the site example.com: site.exe --update-php-settings example.com -settings my_file |
|
|
Sets the file containing custom PHP settings for a site. The file can include any PHP directive except 16 general PHP settings exposed to the Plesk GUI. Used with |
To add directives to custom PHP configuration from the file my_file_add (example.com): site.exe --update-php-settings example.com -additional-settings my_file_add |
|
|
Sets the maximum number of outgoing messages from a specified site (per hour). To set the Unlimited value, specify "-1". Specify "default" to set the value specified in server-wide settings. |
To set the limit on outgoing email messages from a domain: site.exe -u example.com |
|
|
Enables or disables the "ICP approved" status for the site. |
To enable the "ICP approved" status for the site example.com and assign the ICP permit with the ID "?ICP?12345678?" to it: site.exe -u example.com -icp-status true -icp-permit "?ICP?12345678?" |
|
|
Specifies the ICP permit ID for the site. |