Share via


Mqbkup

Updated: April 17, 2012

Applies To: Windows 7, Windows Server 2008 R2

Backs up MSMQ message files and registry settings to a storage device and restores previously-stored messages and settings. For examples of how this command can be used, see Examples.

Both the backup and the restore operation will stop the local MSMQ service. If the MSMQ service was started beforehand, the utility will attempt to restart the MSMQ service at the end of the backup or the restore operation. If the service was already stopped before running the utility, no attempt to restart the service is made.

Before using the MSMQ Message Backup/Restore utility you must close all local applications that are using MSMQ.

Syntax

Mqbkup {/b | /r} <folder path_to_storage_device>

Parameters

Parameter Description

/b

Specifies backup operation

/r

Specifies restore operation

<folder path_to_storage_device>

Specifies the path where the MSMQ message files and registry settings are stored

/?

Displays Help at the command prompt.

Examples

To backup all MSMQ message files and registry settings and store them in the Msmqbkup folder on your C: drive.

Mqbkup /b c:\msmqbkup

If the specified folder does not exist, the utility will automatically create one. If you choose to specify an existing folder, this folder must be empty. If you specify a non-empty folder, the utility will delete every file and subfolder contained within it. In this case, you will be prompted to give permission to delete existing files and subfolders. You can use the /y parameter to indicate that you agree beforehand to the deletion of all existing files and subfolders in the specified folder.

To delete all files and subfolders in the Oldbkup folder on your C: drive and store MSMQ message files and registry settings in this folder.

Mqbkup /b /y c:\oldbkup

To restore MSMQ messages and registry settings:

Mqbkup /r c:\msmqbkup

The locations of folders used to store MSMQ message files are stored in the registry. Thus, the utility will restore MSMQ message files to the folders specified in the registry and not to the storage folders used before the restore operation. If the folders specified in the registry do not exist, the restore operation will automatically create them. If folders directories do exist and are not empty, the utility will prompt you for permission to delete the current contents of these folders.

Additional references