pleskrestore.exe: Restoration from Backups
The pleskrestore.exe
utility is used for restoring data from backup archives.
Usage
Example
The following command restores only databases from the file Backup-file.
Commands
Command | Parameter | Description | Example |
---|---|---|---|
|
|
Restores a backup file. |
To restore the backup file Backup-file: pleskrestore.exe --restore "Backup-file" |
|
|
Checks a backup file integrity. |
To check the integrity of the backup file Backup-file: pleskrestore.exe --check-backup "Backup-file" |
|
|
Shows description of a backup file. |
To view description of the backup file Backup-file: pleskrestore.exe --info "Backup-file" or pleskrestore.exe -i "Backup-file" |
|
|
Shows the status of an asynchronous restoration task. |
To view the status of the restoration task 123: pleskrestore.exe --get-restore-task-status "123" |
|
|
Displays help on the use of the utility. |
To view help on the use of the utility: pleskrestore.exe --help or pleskrestore.exe -h |
|
|
Displays detailed help on the use of the utility with the examples. |
To view detailed help on the use of the utility: pleskrestore.exe --man or pleskrestore.exe -m |
Options
Option | Parameter | Description | Example |
---|---|---|---|
|
|
Specifies the restoration level: restores customers, resellers, or domains from backup, or restores a server-wide backup. |
To restore the server-wide backup from the backup file Backup-file: pleskrestore.exe --restore "Backup-file" -level server |
|
|
Specifies a list of domains, customers, or resellers for restoration. The list may be read from a file, |
To restore the domains domain1 and domain2 from the backup file Backup-file: pleskrestore.exe --restore "Backup-file" -level domains -filter domain1,domain2 |
|
|
Specifies a list of mailboxes for restoration. The list can be read from a file or specified in a comma-separated list. The format of a list item is Use the additional option |
To restore the mailbox mail@example.com for the subscription Example from the backup file Backup-file: pleskrestore.exe --restore "Backup-file" -only-mailboxes "mail@example.com" -domain-name "Example" |
|
|
Specifies a list of mailing lists for restoration. The list can be read from a file or specified in a comma-separated list. The format of a list item is Use the additional option |
To restore the maillist maillist@example.com for the subscription Example from the backup file Backup-file: pleskrestore.exe --restore "Backup-file" -only-maillists "maillist@example.com" -domain-name "Example" |
|
|
Specifies a list of databases for restoration. The list can be read from a file or specified in a comma-separated list. The format of a list item is Use the additional option |
To restore databases specified in the file databases-list for the subscription Example from the backup file Backup-file: pleskrestore.exe --restore "Backup-file" -only-databases "databases-list" -domain-name "Example" |
|
|
Specifies a list of files or directories for restoration. The list can be read from a file or specified in a comma-separated list. Paths to files and directories should be relative to the subscription root. Use the additional option |
To restore files and directories specified in the file directories-list for the subscription Example from the backup file Backup-file: pleskrestore.exe --restore "Backup-file" -only-web-content "directories-list" -domain-name "Example" |
|
|
Specifies a list of sites for restoration. The list can be read from a file or specified in a comma-separated list. The format of a list item is Use the additional option |
To restore sites specified in the file sites-list for the subscription Example from the backup file Backup-file: pleskrestore.exe --restore "Backup-file" -only-sites "sites-list" -domain-name "Example" |
|
|
Specifies a list of DNS zones for restoration. The list can be read from a file or specified in a comma-separated list. The format of a list item is Use the additional option |
To restore DNS zones specified in the file zones-list for the subscription Example from the backup file Backup-file: pleskrestore.exe --restore "Backup-file" -only-dns-zones "zones-list" -domain-name "Example" |
|
|
Specifies a list of SSL certificates for restoration. The list can be read from a file or specified in a comma-separated list. The format of a list item is Use the additional option Use the additional option |
To restore SSL certificates specified in the file certificates-list for the subscription Example from the backup file Backup-file: pleskrestore.exe --restore "Backup-file" -only-certificates "certificates-list" -domain-name "Example" |
|
|
Specifies the domain name. Used with the |
To restore files and directories specified in the file directories-list for the subscription Example from the backup file Backup-file: pleskrestore.exe --restore "Backup-file" -only-web-content "directories-list" -domain-name "Example" |
|
|
Restores only configuration (without content). Used with the |
To restore only configuration of sites specified in the file sites-list for the subscription Example from the backup file Backup-file: pleskrestore.exe --restore "Backup-file" -only-sites "sites-list" -configuration-only -domain-name "Example" |
|
|
Restores only content (without configuration). Used with the |
To restore only content of sites specified in the file sites-list for the subscription Example from the backup file Backup-file: pleskrestore.exe --restore "Backup-file" -only-sites "sites-list" -content-only -domain-name "Example" |
|
|
Restores SSL certificates only from the server pool. Used with the |
To restore SSL certificates specified in the file certificates-list and belonging to the server pool for the subscription Example from the backup file Backup-file: pleskrestore.exe --restore "Backup-file" -only-certificates "certificates-list" -server-pool -domain-name "Example" |
|
|
Restores the Plesk license key. |
To restore the Plesk license from the backup file Backup-file: pleskrestore.exe --restore "Backup-file" -license |
|
|
Enables the quiet restoration mode. |
To restore the backup file Backup-file in the quite mode: pleskrestore.exe --restore "Backup-file" -quite |
|
|
Enables the verbose restoration mode. |
To restore the backup file Backup-file in the verbose mode: pleskrestore.exe --restore "Backup-file" -verbose |
|
|
Enables debugging during restoration. |
To restore the backup file Backup-file in the debugging mode: pleskrestore.exe --restore "Backup-file" -debug |
|
|
Hides warning messages during restoration of a server-wide backup. Used with the |
To restore the server-wide backup from the backup file Backup-file without showing warning messages: pleskrestore.exe --restore "Backup-file" -level server -nowarning |
|
|
Specifies a dump file for restoration. Should be used as |
To restore the backup from the dump file File: pleskrestore.exe -dump-file "File" |
|
|
Specifies a parameters file. Should be used as |
To restore the backup from the parameters file File: pleskrestore.exe -param-file "File" |
|
|
Specifies a file with conflict resolution rules. Used with the |
To restore the backup from the backup file Backup-file with the conflict resolution rules specified in the Conflict-rules file: pleskrestore.exe --restore "Backup-file" -conflict-resolution "Conflict-rules" |
|
|
If you used password protection for a backup, use this option to specify the password. You can also set the password with the PLESK_BACKUP_PASSWORD environment variable. |
To restore the backup protected with the password PaSsWoRd from the backup file Backup-file: pleskrestore.exe --restore "Backup-file" -backup-password "PaSsWoRd" |
|
|
Allows you to restore a backup without providing the backup password. Note that in this case, some sensitive data will not be restored properly. For example, user passwords will be replaced with random ones, the information about already installed APS apps will be lost, and so on. |
To restore the backup protected with the password without providing the password from the backup file Backup-file: pleskrestore.exe --restore "Backup-file" -ignore-backup-password |
|
|
Restores a backup file despite a corrupted signature. |
To restore the backup from the backup file Backup-file despite a corrupted signature: pleskrestore.exe --restore "Backup-file" -ignore-sign |
|
|
Restores a backup file asynchronously. It returns the restoration task identifier, which you can use to retrieve the task status. Used with the |
To restore the backup from the backup file Backup-file asynchronously: pleskrestore.exe --restore "Backup-file" -async |