DiskID (Standard 8 Module Reference)

7/8/2014

Review the applicable Embedded Core modules and any examples for the DiskID setting in Windows Embedded 8 Standard (Standard 8).

This setting contains an integer that specifies the identification number of the disk to configure or to which the image is to be installed on the destination device, numbered beginning from 0 (zero). Disks are numbered 0, 1, 2, and so on, in the order they are created, unless you use this setting to specify otherwise.

You can configure disk partitions manually in the disk configuration user interface (UI) in Windows Setup, or automatically by using settings in the Disk element. If you do not specify a Disk element and WillShowUI setting is set to Never, Windows logs an error, and the installation terminates.

Modules

The following table shows the modules that you can apply this setting to. In Image Configuration Editor (ICE), you can follow the corresponding path to set this setting for a module.

Module

Path

Setting Description

Setup

Products/Embedded Core/Setup/DiskConfiguration/Disk/DiskID

Specifies the identification number of the disk to configure.

Setup

Products/Embedded Core/Setup/ImageInstall/DataImage/InstallTo/DiskID

Specifies the identification number of the disk on which to install a data image.

Setup

Products/Embedded Core/Setup/ImageInstall/OSImage/InstallTo/DiskID

Specifies the identification number of the disk on which to install the image.

Setup

Products/Embedded Core/Setup/WindowsDeploymentServices/ImageSelection/InstallTo/DiskID

Specifies the identification number of the disk to which to install the image. This sequence starts with 0. If you are installing to a computer with a single disk, you must specify 0. Disk_ID is an integer.

SystemMaintenanceService

Products/Embedded Core/SystemMaintenanceService/CacheList/Cache/DiskID

Specifies the Disk ID that identifies the ReadyBoost device. This value is used with PartitionID.

XML Example

The following XML examples show how to configure DiskID.

Disk Configuration

The following XML example shows how to identify the disks to configure.

<DiskConfiguration>
  <!-- First hard drive -->
  <Disk wcm:action="add">
    <DiskID>0</DiskID> 
  </Disk>

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

For full examples, see Disk Configuration XML Example and System with Two Hard Drives XML Example.

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

Windows Deployment Services

The following XML example shows how to install the image to disk 0, partition 1.

<OSImage>
    <InstallTo>
         <DiskID>0</DiskID>
         <PartitionID>1</PartitionID>
    </InstallTo>
</OSImage>

For an example of a complete Windows Deployment Services deployment, see Complete Windows Deployment Services deployment XML Example.

OS Image DiskID

The following XML example shows a configuration for a UEFI-based system with two hard drives.

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

System Maintenance Cache DiskID

The following example XML shows how to configure DiskID to identify the ReadyBoost device.

<CacheList>
  <Cache>
    <CacheID>ReadyBoostCache1</CacheID>
    <DiskID>1</DiskID>
    <PartitionID>1</PartitionID>
    <CacheSizeMB>1024</CacheSizeMB>
    <EnableCompression>false</EnableCompression>
    <EnableEncryption>true</EnableEncryption>
  </Cache>

For an XML example that shows how to configure ReadyBoost devices, see SystemMaintenanceService XML Example.

DataImage DiskID

The following example shows how to set the location in which to install a data image.

<ImageInstall>
    <DataImage wcm:action="add">
        <InstallTo>
            <DiskID>0</DiskID>
            <PartitionID>2</PartitionID>
        </InstallTo>
    </DataImage>
</ImageInstall>

For an XML example that shows how to set the ImageInstall setting to install both an operating system image and a data image, see Setting the ImageInstall Setting XML Example.

See Also

Concepts

Embedded Core Settings