DiskID specifies the identification number of the disk to configure.

Values

disk_identification_number

Specifies the identification number of the disk to configure.

The value 0 specifies the first disk, while the value 1 specifies the second disk, and so on.

Valid Configuration Passes

windowsPE

Parent Hierarchy

Applies To

For a 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 a configuration for a UEFI-based system with two hard drives.

  Copy Code
<DiskConfiguration>

  <!-- First hard drive -->
  <Disk wcm:action="add">

	<DiskID>0</DiskID> 
	<WillWipeDisk>true</WillWipeDisk> 
	<CreatePartitions>

	<!-- Recovery partition -->
	<CreatePartition wcm:action="add">
		<Order>1</Order> 
		<Type>Primary</Type> 
		<Size>250</Size> 
	</CreatePartition>

	<!-- EFI system partition (ESP) -->
	<CreatePartition wcm:action="add">
		<Order>2</Order> 
		<Type>EFI</Type> 
		<Size>100</Size> 
	</CreatePartition>

	<!-- Microsoft reserved partition (MSR) -->
	<CreatePartition wcm:action="add">
		<Order>3</Order> 
		<Type>MSR</Type> 
		<Size>128</Size> 
	</CreatePartition>

	<!-- Windows partition -->
	<CreatePartition wcm:action="add">
		<Order>4</Order> 
		<Type>Primary</Type> 
		<Extend>true</Extend> 
	</CreatePartition>

	</CreatePartitions>
	<ModifyPartitions>

	<!-- Recovery partition -->
	<ModifyPartition wcm:action="add">
		<Order>1</Order> 
		<PartitionID>1</PartitionID> 
		<Label>Recovery</Label> 
		<Format>NTFS</Format> 
		<TypeID>de94bba4-06d1-4d40-a16a-bfd50179d6ac</TypeID> 
	</ModifyPartition>
	</ModifyPartitions>

	<!-- EFI system partition (ESP) -->
	<ModifyPartition wcm:action="add">
		<Order>2</Order> 
		<PartitionID>2</PartitionID> 
		<Label>System</Label> 
		<Format>FAT32</Format> 
	</ModifyPartition>

	<!-- MSR partition does not need to be modified -->

	<!-- Windows partition -->
	<ModifyPartition wcm:action="add">
		<Order>3</Order> 
		<PartitionID>4</PartitionID> 
		<Label>Windows</Label> 
		<Letter>C</Letter> 
		<Format>NTFS</Format> 
	</ModifyPartition>
	</ModifyPartitions>
  </Disk>

  <!-- Second hard drive -->
  <Disk wcm:action="add">
	<DiskID>1</DiskID> 
	<WillWipeDisk>true</WillWipeDisk> 
	<CreatePartitions>

	<!-- Data partition -->
	<CreatePartition wcm:action="add">
		<Order>1</Order> 
		<Type>Primary</Type> 
		<Extend>true</Extend> 
	</CreatePartition>

	</CreatePartitions>
	<ModifyPartitions>

	<!-- Data partition -->
	<ModifyPartition wcm:action="add">
		<Order>1</Order> 
		<PartitionID>1</PartitionID> 
		<Label>Data</Label> 
		<Letter>D</Letter> 
		<Format>NTFS</Format> 
	</ModifyPartition>

	</ModifyPartitions>
  </Disk>


  <WillShowUI>OnError</WillShowUI> 
</DiskConfiguration>


<ImageInstall>
  <OSImage>
	<InstallTo>
	<DiskID>0</DiskID> 
	<PartitionID>4</PartitionID> 
	</InstallTo>
  </OSImage>
</ImageInstall>

For full XML examples and recommended partition configurations, see How to Configure UEFI/GPT-Based Hard Disk Partitions or How to Configure BIOS/MBR-Based Hard Disk Partitions.

See Also

Concepts

Disk