Add

Applies To: Windows 7, Windows Server 2008, Windows Server 2008 R2

Mirrors the simple volume with focus to the specified disk.

Important

This DiskPart command is not available in any edition of Windows Vista.

For examples of how this command can be used, see Examples.

Syntax

add disk=<n> [align=<n>] [wait] [noerr]

Parameters

Parameter Description

disk=<n>

Specifies a disk, other than the one containing the existing simple volume, to contain the mirror. You can mirror only simple volumes. The specified disk must have unallocated space at least as large as the size of the simple volume you want to mirror.

align=<n>

Typically used with hardware RAID Logical Unit Number (LUN) arrays to improve performance. Aligns all volume or partition extents to the closest alignment boundary. n is the number of kilobytes (KB) from the beginning of the disk to the closest alignment boundary.

wait

Waits for the volume to finish synchronizing with the added disk before returning. Without this parameter, DiskPart returns after the mirrored volume is created and does not wait for the synchronization to complete.

noerr

For scripting only. When an error is encountered, DiskPart continues to process commands as if the error did not occur. Without this parameter, an error causes DiskPart to exit with an error code.

Remarks

  • A volume must be selected for this operation to succeed. Use the select volume command to select a volume and shift the focus to it.

Examples

To create a mirror of the volume with focus on disk 2, type:

add disk=2

Additional references

Command-Line Syntax Key

DiskPart