Creates a primary partition on the basic disk with focus.

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

Syntax

create partition primary [size=<n>] [offset=<n>] [id={byte|guid}] [align=<n>] [noerr]

Parameters

Parameter Description

size=<n>

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 free.

id={byte|guid}

Intended for Original Equipment Manufacturer (OEM) use only.

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.

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.

Remarks

Caution

Creating partitions with the id={byte|guid} parameter might cause your computer to fail or be unable to start up. Unless you are an OEM or an IT professional experienced with GPT disks, do not create partitions on GPT disks using this parameter. Instead, always use the create partition efi command to create EFI System partitions, the create partition msr command to create Microsoft Reserved partitions, and the create partition primary command (without the id={byte|guid} parameter) to create primary partitions on GPT disks.

  • After you create the partition, the focus automatically shifts to the new partition.

  • The partition does not receive a drive letter. You must use the assign command in DiskPart to assign a drive letter to the partition.

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

Examples

To create a primary partition of 1000 megabytes in size, type:

create partition primary size=1000

Additional references


Converted from CHM to HTML with chm2web Pro 2.85 (unicode)