ImageSelection

Note

These settings don't apply to Windows 11

ImageSelection specifies the image to be installed and the location to which it is installed, as well as whether the user interface (UI) is displayed.

Child Elements

Setting Description
InstallImage Specifies the file name, the image group, and the name of the image to be installed.
InstallTo Specifies the location to which the image is to be installed.
WillShowUI Specifies in what circumstances the UI is displayed.

Valid Configuration Passes

windowsPE

Parent Hierarchy

Microsoft-Windows-Setup | WindowsDeploymentServices | ImageSelection

Applies To

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

XML Example

The following XML output shows a complete Windows Deployment Services deployment.

<WindowsDeploymentServices>
   <Login>
      <WillShowUI>OnError</WillShowUI>
      <Credentials>
         <Username>Administrator</Username>
         <Domain>MY-DOMAIN-NAME</Domain>
         <Password>********</Password>
      </Credentials>
   </Login>
  <ImageSelection>
      <WillShowUI>OnError</WillShowUI>
      <InstallImage>
         <ImageName>MY_IMAGE_NAME</ImageName>
         <ImageGroup>My IMAGE GROUP</ImageGroup>
      </InstallImage>
      <InstallTo>
         <DiskID>0</DiskID>
         <PartitionID>1</PartitionID>
      </InstallTo>
   </ImageSelection>
</WindowsDeploymentServices>
<DiskConfiguration>
   <WillShowUI>OnError</WillShowUI>
   <Disk>
      <DiskID>0</DiskID>
      <WillWipeDisk>false</WillWipeDisk>
      <ModifyPartitions>
         <ModifyPartition>
            <Order>1</Order>
            <PartitionID>3</PartitionID>
            <Letter>C</Letter>
            <Label>TestOS</Label>
            <Format>NTFS</Format>
            <Active>true</Active>
            <Extend>false</Extend>
         </ModifyPartition>
      </ModifyPartitions>
   </Disk>
</DiskConfiguration>

WindowsDeploymentServices