CLI zmbackupquery Network Edition only

Revision as of 22:59, 16 May 2011 by Gayle (talk | contribs)

Admin Article

Article Information

This article applies to the following ZCS versions.

ZCS 7.0 Article ZCS 7.0 ZCS 6.0 Article ZCS 6.0 ZCS 5.0 Article ZCS 5.0

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: ZCS 6.0 Date Created: 5/2/2006
Article ID: Date Modified: 2011-05-16

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