CLI zmbackupquery Network Edition only

CLI zmbackupquery Network Edition only

   KB 1485        Last updated on 07/11/2015  

(0 votes)
Article-check.png  - This is certified documentation and is protected for editing by Zimbra Employees & Moderators only.
 - This is archive documentation, which means it is not supported or valid for recent versions of Zimbra Collaboration.
 - This article is a Work in Progress, and may be unfinished or missing sections.

For the most recent information on this CLI, including syntax and description, see ZCS Administrator's Guide Network Edition > Appendix A Command-Line Utilities.

ZCS 6.0.x


The zmbackupquery command is used to find full backup sets. The command can be used to find a specific full backup set or full backup sets since a specific date, or all backup sets in the backup directory.

To find out the best full backup to use as the basis for point-in-time restore of an account, run a command like this:

$ zmbackupquery -a <account email> --type full --to <restore-to time>


zmbackupquery [options]


Long Name Short Name Description
--account -a <arg> Account email addresses separated by white space or all for all accounts
--debug -d Display diagnostics for debugging purposes
--help -h Shows the help for the usage options for this tool
--from <arg> List backups whose start date/time is at or after the date/time specified here.
--label -lb <arg> The label of the full backup session to query. An example of a label is backup200507121559510.
--server -s <arg> Mail server host name. For format, use either the plain host name or the name. The default is the localhost name.
--target -t <arg> Specifies the backup target location (The default is <zimbra_home>/backup.)
--to <arg> List backups whose start date/time is at or before the date/time specified here.
--type <arg> Backup set type to query. “full” or “incremental”, both are queried if one is not specified.
--verbose -v Returns detailed status information

Date/Time Formats

Specify date/time in one of these formats:

2008/12/16 12:19:23
2008/12/16 12:19:23 257
2008/12/16 12:19:23.257

Specify year, month, date, hour, minute, second, and optionally millisecond.

Month/date/hour/minute/second are 0-padded to 2 digits, millisecond to 3 digits.

Hour must be specified in 24-hour format, and time is in local time zone.

ZCS 5.0.x

ZCS 4.5.x

Verified Against: Zimbra Collaboration 7.0, 6.0 Date Created: 5/2/2006
Article ID: Date Modified: 07/11/2015

Try Zimbra

Try Zimbra Collaboration with a 60-day free trial.
Get it now »

Want to get involved?

You can contribute in the Community, Wiki, Code, or development of Zimlets.
Find out more. »

Looking for a Video?

Visit our YouTube channel to get the latest webinars, technology news, product overviews, and so much more.
Go to the YouTube channel »

Jump to: navigation, search