Creates a primary partition on the basic disk with focus. After the partition has been created, the focus automatically shifts to the new partition.
Important: A basic disk must be selected for this operation to succeed. You must use the select disk command to select a basic disk and shift the focus to it.
Syntax
create partition primary [size=<n>] [offset=<n>] [id={ <byte> | <guid> }] [align=<n>] [noerr]
Parameters
| Parameter | Description |
|---|---|
size=<n> |
Specifies the size of the partition in megabytes (MB). If no size is given, the partition continues until there is no more unallocated space in the current region. |
offset=<n> |
The offset in kilobytes (KB), at which the partition is created. If no offset is given, the partition will start at the beginning of the largest disk extent that is large enough to hold it. |
align=<n> |
Aligns all partition extents to the closest alignment boundary. Typically used with hardware RAID Logical Unit Number (LUN) arrays to improve performance. <n> is the number of kilobytes (KB) from the beginning of the disk to the closest alignment boundary. |
| id={ `<byte> | <guid>` } |
| noerr | For scripting only. When an error is encountered, DiskPart continues to process commands as if the error did not occur. Without the noerr parameter, an error causes DiskPart to exit with an error code. |
Examples
To create a primary partition of 1000 megabytes in size, type:
create partition primary size=1000
Related links
Source: Microsoft Learn / Windows Server documentation by Microsoft and contributors (upstream author metadata: robinharwood). Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
