CLI zmmailboxmove Network Edition only
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
zmmailboxmove
This command is used to move a mailbox from one Zimbra server to another. Mailboxes can be moved between Zimbra servers that share the same LDAP server. All the files are copied to the new server and LDAP is updated. After the mailbox is moved to a new server, a copy still remains on the older server, but the status of old mailbox is closed. Users cannot log on and mail is not delivered. You should check to see that all the mailbox contents were moved successfully before purging the old mailbox.
Syntax
zmmailboxmove {-a <arg>} {-t <arg>|-po} [options]
Description
Long Name | Short Name | Description |
---|---|---|
--account | -a | <arg> Email address of account to move |
--help | -h | Shows the help for the usage options for this command |
--overwriteMailbox | -ow | Overwrite target mailbox, if it exists |
--purgeOld | -po | Purge old mailbox on previous server. After a mailbox has been successfully moved to a new server, perform purgeOld to remove the mailbox and its contents from the previous server. |
--server | -s | <arg> Mail server hostname. The default is the localhost. Server where the --account mailbox is located. |
--targetServer | -t | <arg> Server where mailbox is moved to Use -t option to move a mailbox from the current server to the new server specified by the option. |
--authtokenfile | -Y | Use auth token string (has to be in JSON format) from command line |
--authtoken | -y | Use auth token string (has to be in JSON format) from command line |
Examples
In these examples, two separate command lines are used to move the mailbox and to purge the old mailbox. This is because -t and -po are mutually exclusive.
- To move a mailbox from the default server to the target server:
zmmailboxmove -a user1@domain.com -t server2.domain.com
- To move a mailbox from the default server to the target server, while overwriting any existing mailbox for the account on the target server:
zmmailboxmove -a user1@domain.com -t server2.domain.com -ow
- To purge an old mailbox from the default server, after checking that the contents of the mailbox were successfully moved to the target server:
zmmailboxmove -a user1@domain.com -po
ZCS 5.0.x
ZCS 4.5.x