Skip to main content

Command line

Besides the graphical interface, O&O DiskImage offers a command line version, oodicmdc.exe, that runs from the Windows command prompt. Open it with Tools > Command Prompt; the graphical interface stays open in the background. The typical path of the executable is C:\Program Files\OO Software\DiskImage\oodicmdc.exe.

Commands are called as oodicmdc.exe <command> [subcommands] [parameters]. Do not insert manual line breaks inside a command; the line breaks of the examples are formatting only. The integrated command line help lists all parameters.

Examples​

oodicmdc.exe /create image /source S: /destination E:\Sample.omg
oodicmdc.exe /validate /source E:\Sample.omg
oodicmdc.exe /restore image /image E:\Sample.omg /source S: /destination T: /OverwriteTargetData

The first command creates a sector-based backup of drive S:, the second validates a backup file, the third restores S: from the backup to T: and overwrites the target.

Sources and destinations​

A drive or disk is addressed in one of these formats:

FormatExample
Drive letterD:
Volume GUID{xxxx-xxxx-xxxx-xxxx}
Disk numberDiskNo 0
Offset of a volume on a disk1048576@1 (Offset@DiskNo)

/create image​

Creates a sector-based backup (image).

ParameterMeaning
/sourceThe drive or disk to back up, in one of the formats above.
/destinationPath and name of the backup file (optional).
/password "…"Password for the encryption; enables the forced dismount if required (optional).
/comment "…"Comment for the backup (optional).
/exclude "…"Excludes objects by path or wildcard (optional).
/type "…""used sector" (default) or "forensic" (optional).
/max <MB>Maximum size of a backup file in MB; larger backups are split (optional).
/format "…""O&O DiskImage" (default), "VHD Format" or "VHDX Format" (optional).
/VirtualDiskType "…""dynamic hard disk" (default) or "fixed hard disk" (optional).

/create image increment​

Creates an incremental sector-based backup on the basis of an existing backup. It takes the parameters of /create image plus the parameters that identify the base backup and the incremental options.

/restore image​

Restores a sector-based backup.

ParameterMeaning
/image "…"Path and name of the backup file.
/source "…"The object in the backup: drive letter, DiskNo X or Offset@DiskNo X@Y.
/destination "…"The target: drive letter, volume GUID, DiskNo X or Offset@DiskNo X@Y (optional).
/DecryptPassword "…"Password of an encrypted backup (optional).
/FillEmptyBlocksNullFills empty sectors with zeros.
/WriteHarddiskDriveWrites directly to the disk instead of through the volume.
/CreateVolumeLikeSourceCreates the target volume like the source volume without prompting.
/IgnoreReadErrorsLogs read errors instead of aborting.
/SetBootPartitionBootableMarks a bootable partition as active.
/ClearTargetDriveClears the target layout without prompting.
/OverwriteTargetDataOverwrites data on the target without prompting.
/IgnoreDataModificationReports data modifications but continues.

/convert image​

Converts a sector-based backup to another format – for example VHD/VHDX – or to other properties.

ParameterMeaning
/image "…"Path and name of the source backup.
/source "…"The drive letter or DiskNo of the source.
/DecryptPassword "…"Password of an encrypted source backup.
/destination "…"Path and name of the target backup.
/destinationPassword "…"Password of the new backup (optional).
/comment "…"Comment (optional).
/max <MB>Maximum size of the target file (optional).
/format "…""O&O DiskImage", "VHD Format" or "VHDX Format" (optional).
/VirtualDiskType "…""dynamic hard disk" (default) or "fixed hard disk" (optional).

/create backup​

Creates a file-based backup (OBK).

ParameterMeaning
/source "…"File names with path, wildcards allowed, for example C:\Data\*.docx.
/destination "…"Path and name of the backup.
/password "…"Password for the encryption (optional).
/dismountForced dismount to protect against changes; the default is a VSS snapshot (optional).
/comment "…"Comment (optional).
/exclude "…"Exclusion filter (optional).
/max <MB>Maximum size of a backup file (optional).
/IgnoreReadErrorsIgnores read errors (optional).

/restore backup​

Restores a file-based backup.

ParameterMeaning
/source "…"Path and name of the backup.
/destination "…"Target directory, full path.
/DecryptPassword "…"Password of an encrypted backup.
/IgnoreReadErrorsIgnores read errors (optional).
/OverwriteTargetDataOverwrites the target without prompting (optional).
/IgnoreDataModificationReports modifications but continues (optional).

/validate​

Checks the integrity of a sector- or file-based backup.

ParameterMeaning
/source "…"Path and name of the backup.
/DecryptPassword "…"Password of an encrypted backup (optional).
/AllSplitsIncludes all parts of a split backup (optional).

/mount image​

Mounts a sector-based backup as a virtual disk.

ParameterMeaning
/source "…"Drive letter or DiskNo of the virtual device.
/image "…"Path and name of the backup file.
/DecryptPassword "…"Password of an encrypted backup (optional).
/driveletter X:The drive letter of the mounted volume.

/unmount image​

Unmounts a mounted sector-based backup: /source "…" names the drive letter or DiskNo of the virtual disk.

/duplicate​

Duplicates a drive or disk (clone).

ParameterMeaning
/source "…"The source: drive letter, volume GUID, DiskNo X or Offset@DiskNo X@Y.
/destination "…"The target, in the same formats.
/dismountProtection against changes with a VSS snapshot (optional).
/exclude "…"Excludes contents (optional).
/type "…""used sector" (default) or "forensic" (optional).
Further options/FillEmptyBlocksNull, /WriteHarddiskDrive, /CreateVolumeLikeSource, /IgnoreReadErrors, /SetBootPartitionBootable, /ClearTargetDrive, /OverwriteTargetData – as for /restore image.

/add license​

Registers the product with /name "…", /company "…" and /serial "…".

/stop​

Stops all running O&O DiskImage actions.

/creating bootable medium​

Creates a bootable medium. The optional parameters /recovery environment, /ADK, /AIK, /installation media, /boot device and /ISO path determine which Windows components are used (Recovery Environment, ADK or AIK), which installation media, the target device (CD/DVD or USB) and the path of the ISO file to create. See Boot medium and O&O DiskImage ToGo.

/show volumes​

Lists the volumes of the system with their drive letters, disk numbers and offsets in bytes. With /image "…", it lists the volumes contained in a backup file.