Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »


ZCB 4.8 and higher supports restore from the command line. These commands can be placed into a batch script for automation purposes.


Command-line and automated restores require that ZCB be installed and that a valid cloud certificate be imported.

All restores via command line are performed to their Original location.

Command-line Restores

To restore from the command line, open a command prompt and navigate to the \bin\ folder in your ZCB installation directory.

Then use the following command

CloudController.exe --command restorecatalog --restoretype <cloud / local> --updatebackupfolder <1 / 0> --restorelocation <Path> --hostname <localhost / * / HOSTNAME> --backupset <Backupset name / *> --cloudLocation <Location>


  • --restoretype <cloud / local>
    • choose cloud to restore from the cloud storage
    • choose local to restore from local disk
  • --updatebackupfolder <1 / 0>
    • Choose 1 to
    • Choose 0 to
  • --restorelocation "<Path>"
    • Use this argument to set the location to which the backup information will be downloaded.
      • You must use two slashes anywhere a single slash would normally exist in the path.
      • You must include trailing slashes
      • Place quotation marks around the entire path.
    • Example path: "C:\\My\\Download\\Folder\\"
  • --hostname <localhost / HOSTNAME / *>
    • Choose localhost to restore backups from the local machine only.
    • Input the HOSTNAME of a specific machine to restore backups from that machine only.
    • Place an asterisk * to restore from all machines for all machines
  • --backupset <Name of backup set / *>
    • Input the name of a specific backup set to restore that backup set
    • Input an asterisk to restore all backup sets
  • --cloudLocation <location>
    • Leave the location blank to restore from all cloud locations
    • Input the name of a specific location to restore backups from all locations. 
      • US (For US Standard)
      • ap-southeast-1 (For Singapore)
      • ap-northeast-1 (For Tokyo - Japan)
      • ap-southeast-2 (For Sydeny - Australia)
      • EU (For Europe)
      • sa-east-1 (Sau Paolo - South America)
      • us-west-1 (North California - US West)
      • us-west-2 (Oregon - US West)

Example commands

Restore all backup sets in all cloud locations for all machines

CloudController.exe --command restoreCatalog --restoretype cloud --updatebackupfolder 1 --restorelocation "C:\\My\\Download\\Folder\\" --hostname * --backupset * --cloudLocation

Restore the backup set MyBackup from the SERVER2 machine stored in the Tokyo location

CloudController.exe" --command restoreCatalog --restoretype cloud --updatebackupfolder 1 --restorelocation "C:\\My\\Download\\Folder\\" --hostname SERVER2 --backupset MyBackup --cloudLocation ap-northeast-1

Restore all backup sets from the FILESERVER machine from backups stored on local disk

<work in progress: command will go here>

Automated Restores

Batch files can be created using the above command-line options. These batch files can be run manually to make command-line restores easier. They can also run automatically with Windows Task Scheduler.

Example batch file

Here is a sample batch file that can be run to restore backups from all backup sets on all machines in all locations.


This file can be edited to support your needs, or you may write your own using the command-line options above.


Help us improve this article!

  • No labels