This documentation is archived and is not being maintained.

CreatePartition

CreatePartition specifies a single partition to create on the hard disk.

If you are installing Windows to a blank hard disk, you must use CreatePartition and ModifyPartition to create and to format partitions on the disk. You must also add values to either InstallTo or InstallToAvailablePartition to specify where to install Windows.

Child Elements

 

Extend

Specifies whether to extend the partition to fill the disk.

Order

Specifies the creation order for multiple partitions.

Size

Specifies the size of the partition to create, in megabytes.

Type

Specifies the type of partition to create. For example, you can specify a primary partition type or an extended partition type.

Valid Passes

Parent Hierarchy

Applies To

For the list of the supported Windows editions and architectures that this component supports, see Microsoft-Windows-Setup.

XML Example

The following XML output for the DiskConfiguration setting shows how to create three partitions on a hard drive.

<DiskConfiguration>
   <WillShowUI>OnError</WillShowUI>
   <Disk>
      <DiskID>0</DiskID>
      <WillWipeDisk>true</WillWipeDisk>
      <CreatePartitions>
         <CreatePartition>
<!-- Create primary partition, 20 GB -->
            <Order>1</Order>
            <Type>Primary</Type>
            <Size>20000</Size>
         </CreatePartition>
<!-- Create extended partition and fill the rest of the hard disk -->
         <CreatePartition>
            <Order>2</Order>
            <Type>Extended</Type>
            <Extend>true</Extend>
         </CreatePartition>
<!-- Create logical partition within the extended partition, 6 GB -->
         <CreatePartition>
            <Order>3</Order>
            <Type>Logical</Type>
            <Size>6000</Size>
         </CreatePartition>
      </CreatePartitions>
   </Disk>
</DiskConfiguration>

See Also

Concepts

CreatePartitions

Show: