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:
| Format | Example |
|---|---|
| Drive letter | D: |
| Volume GUID | {xxxx-xxxx-xxxx-xxxx} |
| Disk number | DiskNo 0 |
| Offset of a volume on a disk | 1048576@1 (Offset@DiskNo) |
/create image
Creates a sector-based backup (image).
| Parameter | Meaning |
|---|---|
/source | The drive or disk to back up, in one of the formats above. |
/destination | Path 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.
| Parameter | Meaning |
|---|---|
/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). |
/FillEmptyBlocksNull | Fills empty sectors with zeros. |
/WriteHarddiskDrive | Writes directly to the disk instead of through the volume. |
/CreateVolumeLikeSource | Creates the target volume like the source volume without prompting. |
/IgnoreReadErrors | Logs read errors instead of aborting. |
/SetBootPartitionBootable | Marks a bootable partition as active. |
/ClearTargetDrive | Clears the target layout without prompting. |
/OverwriteTargetData | Overwrites data on the target without prompting. |
/IgnoreDataModification | Reports data modifications but continues. |
/convert image
Converts a sector-based backup to another format – for example VHD/VHDX – or to other properties.
| Parameter | Meaning |
|---|---|
/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).
| Parameter | Meaning |
|---|---|
/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). |
/dismount | Forced 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). |
/IgnoreReadErrors | Ignores read errors (optional). |
/restore backup
Restores a file-based backup.
| Parameter | Meaning |
|---|---|
/source "…" | Path and name of the backup. |
/destination "…" | Target directory, full path. |
/DecryptPassword "…" | Password of an encrypted backup. |
/IgnoreReadErrors | Ignores read errors (optional). |
/OverwriteTargetData | Overwrites the target without prompting (optional). |
/IgnoreDataModification | Reports modifications but continues (optional). |
/validate
Checks the integrity of a sector- or file-based backup.
| Parameter | Meaning |
|---|---|
/source "…" | Path and name of the backup. |
/DecryptPassword "…" | Password of an encrypted backup (optional). |
/AllSplits | Includes all parts of a split backup (optional). |
/mount image
Mounts a sector-based backup as a virtual disk.
| Parameter | Meaning |
|---|---|
/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).
| Parameter | Meaning |
|---|---|
/source "…" | The source: drive letter, volume GUID, DiskNo X or Offset@DiskNo X@Y. |
/destination "…" | The target, in the same formats. |
/dismount | Protection 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.