...
- No xml definition required to start an Image backup or restore
- Runs completely in the background with no user interface
- Handles the most common backup and restore scenarios with simple command line arguments
- MRAuto.exe system restore tasks will automatically boot into the Macrium Rescue media to complete the restore process
...
title | Download |
---|
MRAuto.exe can be found in the Macrium Reflect installation folder. Typically, 'C:\Program Files\Macrium\Reflect'
Note: This utility is not available with Macrium Free.
...
Info | ||
---|---|---|
| ||
MRAuto.exe requires administrative privilege to run. To see the help information, please open a command prompt as Administrator and run mrauto.exe. The options are case-insensitive and can be used in short for '-' or long form '--'. |
Info | ||
---|---|---|
| ||
MRAuto.exe exit status code can be obtained from %ERRORLEVEL% in the command prompt. Return value 0 means success and all other values indicate a failure. For Restore tasks, which completed booting into Rescue media, the status code can be queried via 'mrauto --status' command. Example: Typing 'echo %ERRORLEVEL%' once MrAuto.exe completed would display exit status code. For detailed error information, please check the corresponding HTML log file stored in C:\ProgramData\Macrium\Reflect, or in the Macrium Reflect Log View. |
Code Block | ||||
---|---|---|---|---|
| ||||
C:\Users\User\Downloads>mrauto.exe Macrium Reflect Auto - Backup/Restore Automation utility. mrauto.exe -[b][r][s][l] <storage location> [backup name] <drive letters/disk numbers> [-t][-u][-p][-i][-e] [--stealth][--quiet] -b | --backup Creates a backup. -r | --restore Restores a backup. -s | --status Displays status of the last auto restore. -l | --list Lists backups in the storage location by time. Lists disks/partitions in the image or system. -f | --filter Filter backup list by wildcard match. Used in --list option. -t | --type Backup type - Full/Diff/Inc. -u | --user Network user name - Domain\User or User -p | --password Network password. -i | --imagepwd Image password for Backup/Restore/List. -e | --encryption AES encryption level for Backups. 0 - none, 1 - 128 bit, 2 - 192 bit, 3 - 256 bit -n | --nowarning Suppress overwrite confirmation during Restore. -v | --verify Verify image file after Backup or before Restore. -w | --wait Wait for in progress Backup/Restore job to finish. --retention Apply Reflect Default Retention Rules. --stealth Suppress backup notifications. --quiet Suppress the Reflect console output. -h | --help Show options. |
...
Backup and Restore supports source disk/partition Partition selections by drive letter or disk and partition number combination. Disk/partition numbers are using Drive Letters, or Disk and Partition number combination separated with the : (colon) character
Info |
---|
Note: Disk and Partition numbers use the 1 based index as shown in Macrium Reflect rather than 0 based index shown in Disk Management console. |
Mixing drive letters Drive Letters and disk Disk numbers in a single operation is not allowed. It either has to be all drive letters or disk number and partition number. However, mixing of disk number and disk# & partition# , however, mixing of Disk number and Disk and Partition number combination is allowed.
Example: mrauto.exe -b <backup location> 1,2:1,2:3
In the above sample, it will backup all partitions contained in disk# Disk 1 and partition Partition 1 and 3 from disk# Disk 2.
To see available disks and partitions in the system please run 'mrauto.exe -l .' command.
Info |
---|
Image name in the Backup command is optional and Macrium Reflect will auto-generate one when not supplied. |
By specifying The --stealth option will supress all Backup notifications. Customers wanting to suppress progress output may specify --quiet option. With the --quiet option, no output from Reflect will be shown and customers may only be able to find exit status via %ERRORLEVEL%
When backup location is of a network share, please make sure the share is added in the Network Share Settings page of Reflect Defaults and Settings options or specify user name & password via options -u and -p.
...
The following example shows incremental backup of all the partitions within disk Disk 7 and Disk 8
The target folder 'E:\Backups' is searched for an existing backup set that contains all partitions for Disks 7 and 8. If found, then in Incremental Image is run, otherwise a Full Image is run
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Validating XML -------------- XML File Name - C:\ProgramData\Macrium\Reflect\mrauto_backup.xml Please wait. Initializing partition information... Validation status - Ok Imaging Summary -------------------------------------------------------------------------------- Backup Definition File: C:\ProgramData\Macrium\Reflect\mrauto_backup.xml Auto Verify: N Verify File System: Y Maximum File Size: Automatic Compression: Medium Password: N Intelligent Copy: Y Power Saving: N Email On Success: N Email On Warning: N Email On Failure: N Total Selected: 6.23 GB Current Time: 27/04/2022 15:04:13 -------------------------------------------------------------------------------- Retention Rules Rules will be applied to all matching backup sets in the destination folder Incremental: Retain 10 incremental backups Create a Synthetic Full backup if possible. Incremental Backups: 0 found -------------------------------------------------------------------------------- Image ID - E02EA1FC9A1CD6C8 -------------------------------------------------------------------------------- Destination Backup Type: Incremental File Name: Append to recent backup in directory 'E:\backups\' E:\backups\E02EA1FC9A1CD6C8-01-01.mrimg -------------------------------------------------------------------------------- Operation 1 of 5 Hard Disk: 7 Drive Letter: N/A File System: Unformatted Label: Size: 16.0 MB Free: 0 B Used: 16.0 MB -------------------------------------------------------------------------------- Operation 2 of 5 Hard Disk: 7 Drive Letter: F Volume: \??\Volume{43484bb0-7c58-4c4c-9244-d3a28cba8d73} File System: NTFS CBT: Y Label: New Volume Size: 61.39 GB Free: 58.23 GB Used: 3.16 GB -------------------------------------------------------------------------------- Operation 3 of 5 Hard Disk: 7 Drive Letter: G Volume: \??\Volume{1bfe6d7e-9ac5-4c17-acf6-cc587d6aa4ff} File System: NTFS CBT: Y Label: New Volume Size: 58.59 GB Free: 55.59 GB Used: 3.00 GB -------------------------------------------------------------------------------- Operation 4 of 5 Hard Disk: 8 Drive Letter: N/A File System: Unformatted Label: Size: 16.0 MB Free: 0 B Used: 16.0 MB -------------------------------------------------------------------------------- Operation 5 of 5 Hard Disk: 8 Drive Letter: H Volume: \??\Volume{8353e3d1-6974-455b-9355-afd27af623f2} File System: NTFS CBT: Y Label: New Volume Size: 9.98 GB Free: 9.95 GB Used: 37.8 MB -------------------------------------------------------------------------------- Starting Image - Wednesday, 27 April 2022 15:04 Initializing Write Method: Using Direct Disk I/O Destination Drive: vms (E:) - Free Space 649.22 GB Image Guardian: Protected Creating Volume Snapshot - Please Wait Volume Snapshots Created -------------------------------------------------------------------------------- Verifying F:\ \??\Volume{43484bb0-7c58-4c4c-9244-d3a28cba8d73} G:\ \??\Volume{1bfe6d7e-9ac5-4c17-acf6-cc587d6aa4ff} H:\ \??\Volume{8353e3d1-6974-455b-9355-afd27af623f2} -------------------------------------------------------------------------------- Saving Partition - <NO NAME> Reading File System Bitmap Saving Partition -------------------------------------------------------------------------------- Saving Partition - New Volume (F:) Reading File System Bitmap CBT Init Success Searching for NTFS meta data Looking for changes Saving Partition -------------------------------------------------------------------------------- Saving Partition - New Volume (G:) Reading File System Bitmap CBT Init Success Searching for NTFS meta data Looking for changes Saving Partition Overall Progress: 65% -------------------------------------------------------------------------------- Saving Partition - <NO NAME> Reading File System Bitmap Saving Partition -------------------------------------------------------------------------------- Saving Partition - New Volume (H:) Reading File System Bitmap CBT Init Success Searching for NTFS meta data Looking for changes Saving Partition -------------------------------------------------------------------------------- Saving Index New File: 711 KB E02EA1FC9A1CD6C8-01-01.mrimg -------------------------------------------------------------------------------- Image Completed Successfully in 00:00:32 I/O Performance: Read 3.2 Gb/s - Write 25.0 Gb/s -------------------------------------------------------------------------------- Trial Edition This Trial License will expire in 809 days Premium features will not function after 14 July 2024 -------------------------------------------------------------------------------- Image Completed Successfully in 00:00:32 -------------------------------------------------------------------------------- |
...
Info |
---|
A backup Image may contain partitions from more than one disk. Restore option currently support restoring of partitions with in a disk. Therefore, it is necessary to select a disk or partition from an image when restoring. This can be achieved by specifying drive letters or disk and partition number after the question mark symbol in the image file name. Example: mrauto.exe -r D:\Backups\Test-00-00.mrimg?C,D,E |
Like Backup command, mixing drive letter and disk numbers in a single operation is not allowed. To see what are drive letters or disk numbers contained within the image, please run 'mrauto.exe -l <full image path>'
...
Code Block | ||||
---|---|---|---|---|
| ||||
C:\Users\User\Downloads>mrauto.exe -r usage: mrauto.exe -r <{[location] [image file]} | {full image path}>[?{vol1,vol2}|{disk1,disk2}|{disk1:par1,disk2:par2}] [target disk] [-u user] [-p pass] [-i imagepass] [--verify][--wait][--nowarning][--quiet] example: mrauto.exe -r D:\Backups Test-00-00.mrimg mrauto.exe -r \\Share\Backups\Test-00-00.mrimg -u User -p Pass -i ImagePass --quiet mrauto.exe -r D:\Backups\Test-00-00.mrimg?C,D,E mrauto.exe -r D:\Backups\Test-00-00.mrimg?1:1,1:2 mrauto.exe -r D:\Backups\Test-00-00.mrimg 1 --wait mrauto.exe -r D:\Backups\Test-00-00.mrimg --verify mrauto.exe -r D:\Backups\Test-00-00.mrimg?1:2 1 NOTE: Restoring multiple disks within an image are not supported. Only multiple partitions in the same disk are supported. For more information type 'mrauto.exe -h' |
The ? (Question mark) character following the file name indicates the Disk, or Disk and Partiton combination list to be restored. If omitted, then all partitions in the image are restored.
Info |
---|
If there is more than one disk in the Image then ? must be specified. |
The next parameter is the 'target disk' Disk number to be restored to, and if omitted then the original disk is used as the restore target,
The following command shows Restoring of all the partitions within disk 7 from the image produced by earlier incremental backup.
Please note the backup image contains partitions Partitions from 2 disks. Without specifying source disk qualifier via ? will result in error.
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
WARNING: The following drives will be overwritten.
Disk# 7 GPT Msft Virtual Disk 1.0 120.00 GB
Partition# 1 Unformatted Microsoft reserved partition 16.0 MB
Partition# 2 (F:) New Volume NTFS Basic data partition 61.39 GB
Partition# 3 (G:) New Volume NTFS Basic data partition 58.59 GB
All target volume data will be overwritten.
Type 'YES' to proceed or 'NO' to cancel: YES
Image ID - D03C0ED2C8CD8635
--------------------------------------------------------------------------------
Dismounting drives
--------------------------------------------------------------------------------
Starting Restore - 28 April 2022 10:11
--------------------------------------------------------------------------------
Image File: E:\backups\E02EA1FC9A1CD6C8-01-01.mrimg
Image ID: E02EA1FC9A1CD6C8
Date: 27 April 2022
Time: 15:04
Image Type: Incremental
--------------------------------------------------------------------------------
Source Disk: Disk 7 GPT [5880D634-1C23-497F-B422-F156B0C58F91] - Msft Virtual Disk 1.0 <120.00 GB>
Geometry: 15665\63\512
Destination Disk: Disk 7 GPT [5880D634-1C23-497F-B422-F156B0C58F91] - Msft Virtual Disk 1.0 <120.00 GB>
Verify: N
Delta: Y
SSD Trim: Y
Power Saving: N
--------------------------------------------------------------------------------
Operation 1 of 3
Restore Partition: 1 - <NO NAME>
Unformatted 16.0 MB / 16.0 MB
Drive Letter: Auto
Start Sector: 34
End Sector: 32,767
Partition Type: Primary
--------------------------------------------------------------------------------
Processing: E02EA1FC9A1CD6C8-00-00.mrimg
Processing: E02EA1FC9A1CD6C8-01-01.mrimg
Restore completed successfully
--------------------------------------------------------------------------------
Operation 2 of 3
Restore Partition: 2 - New Volume (F:)
NTFS 94.6 MB / 61.39 GB
Drive Letter: F:
Start Sector: 32,768
End Sector: 128,774,143
Partition Type: Primary
--------------------------------------------------------------------------------
Looking for changes
Processing: E02EA1FC9A1CD6C8-00-00.mrimg
Processing: E02EA1FC9A1CD6C8-01-01.mrimg
Restore completed successfully
--------------------------------------------------------------------------------
Operation 3 of 3
Restore Partition: 3 - New Volume (G:)
NTFS 94.4 MB / 58.59 GB
Drive Letter: G:
Start Sector: 128,774,144
End Sector: 251,654,143
Partition Type: Primary
--------------------------------------------------------------------------------
Looking for changes
Processing: E02EA1FC9A1CD6C8-00-00.mrimg
Processing: E02EA1FC9A1CD6C8-01-01.mrimg
Restore completed successfully
--------------------------------------------------------------------------------
UpdateGPTMountedDevices - No modified GUID
--------------------------------------------------------------------------------
Trial Edition
This Trial License will expire in 808 days
Premium features will not function after 14 July 2024
--------------------------------------------------------------------------------
Restore completed in 00:00:05
--------------------------------------------------------------------------------
I/O Performance: Read 2.8 Gb/s - Write 2.8 Gb/s |
...
List command 'mrauto.exe -l <image files folder>' lists all the files inside the folder. Optional wildcard filter cam can be used to narrow the search.
Code Block | ||||
---|---|---|---|---|
| ||||
usage: mrauto.exe -l <[backup file folder] | [full image path] | [.]> [-u user] [-p pass] [-i imagepass] [-f filter] example: mrauto.exe -l D:\Backups -f *.mrimg mrauto.exe -l D:\Backups\Test.mrimg mrauto.exe -l \\Share\Backups\Test.mrimg -u User -p Pass mrauto.exe -l D:\Backups\Test.mrimg -i ImagePass mrauto.exe -l . For more information type 'mrauto.exe -h' |
To display all the disks Disks and partitions Partitions in the system
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
List of available Disks and Partitions. Disk# and Partition# are 1 based index as shown in Macrium Reflect. --------------------------------------------------------------------------- Disk# 3 GPT GIGABYTE GP-GSM2NE8128GNTD E8TM14.2 119.24 GB Partition# 1 Recovery NTFS Primary 529.0 MB Partition# 2 NO NAME FAT32 (LBA) Primary 96.0 MB Partition# 3 Unformatted Primary 16.0 MB Partition# 4 (C:) NTFS Primary 118.61 GB --------------------------------------------------------------------------- Disk# 5 GPT Msft Storage Space 0.1 2.04 TB Partition# 1 Unformatted Primary 16.0 MB Partition# 2 (D:) source NTFS Primary 2.04 TB --------------------------------------------------------------------------- Disk# 6 GPT Msft Storage Space 0.1 2.04 TB Partition# 1 Unformatted Primary 16.0 MB Partition# 2 (E:) vms NTFS Primary 2.04 TB --------------------------------------------------------------------------- Disk# 7 GPT Msft Virtual Disk 1.0 120.00 GB Partition# 1 Unformatted Primary 16.0 MB Partition# 2 (F:) New Volume NTFS Primary 61.39 GB Partition# 3 (G:) New Volume NTFS Primary 58.59 GB --------------------------------------------------------------------------- Disk# 8 GPT Msft Virtual Disk 1.0 10.00 GB Partition# 1 Unformatted Primary 16.0 MB Partition# 2 (H:) New Volume NTFS Primary 9.98 GB --------------------------------------------------------------------------- |
To display all the disk Disk and partitions Partitions within an image
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
List of available Disks and Partitions. Disk# and Partition# are 1 based index as shown in Macrium Reflect. ------------------------------------------------------------------------------------------- Disk# 7 GPT Msft Virtual Disk 1.0 120.00 GB Partition# 1 Unformatted Microsoft reserved partition 16.0 MB Partition# 2 (F:) New Volume NTFS Basic data partition 61.39 GB Partition# 3 (G:) New Volume NTFS Basic data partition 58.59 GB ------------------------------------------------------------------------------------------- Disk# 8 GPT Msft Virtual Disk 1.0 10.00 GB Partition# 1 Unformatted Microsoft reserved partition 16.0 MB Partition# 2 (H:) New Volume NTFS Basic data partition 9.98 GB ------------------------------------------------------------------------------------------- |
To list all the image Image files in a folder
Please note: The file timestamp displayed will be file creation time which will closely match with the timestamp displayed in Reflect Image View.
...