InstallTo (microsoft-windows-setup-imageinstall-osimage-installto)

InstallTo specifies the disk and partition where you install the Windows operating system image.

You must specify valid values for the DiskID and PartitionID settings. If you are installing to a blank disk, you must create and format partitions with the CreatePartitions and ModifyPartitions settings.

Comparison of OSImage Settings: InstallTo and InstallToAvailablePartition

For unattended installations, you must specify either the InstallTo or the InstallToAvailablePartition setting.

Microsoft-Windows-Setup\ImageInstall\OSImage\InstallTo

Installs Windows to a specified disk and partition.

Microsoft-Windows-Setup\ImageInstall\OSImage\InstallToAvailablePartition

Installs Windows to the first available partition that has enough space and does not already contain an installation of Windows.

Note

In the OSImage setting, if you set the InstallToAvailablePartition setting to true, do not set the InstallTo setting. If both InstallToAvailablePartition and InstallTo are set the installation will fail.

Child Elements

Setting Description
DiskID Specifies the disk identifier of the hard disk on which to install Windows.
PartitionID Specifies the partition identifier of the partition on which to install Windows.

Valid Configuration Passes

windowsPE

Parent Hierarchy

Microsoft-Windows-Setup | ImageInstall | OSImage | InstallTo

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 shows how to set the ImageInstall setting to install both an operating-system image and a data image.

<ImageInstall>
    <OSImage>
        <InstallFrom>
            <Credentials>
                <Domain>FabrikamDomain</Domain>
                <Password>MyPassword</Password>
                <Username>MyUsername</Username>
            </Credentials>
            <Path>\\networkshare\share\install.wim</Path>
            <MetaData wcm:action="add">
                <Key>/IMAGE/NAME</Key>
                <Value>FabrikamCustomOSImage</Value>
            </MetaData>
        </InstallFrom>
        <InstallTo>
            <DiskID>0</DiskID>
            <PartitionID>1</PartitionID>
        </InstallTo>
        <WillShowUI>OnError</WillShowUI>
        <InstallToAvailablePartition>false</InstallToAvailablePartition>
    </OSImage>
    <DataImage wcm:action="add">
        <InstallTo>
            <DiskID>0</DiskID>
            <PartitionID>2</PartitionID>
        </InstallTo>
        <InstallFrom>
            <Credentials>
                <Domain>FabrikamDomain</Domain>
                <Password>MyPassword</Password>
                <Username>MyUsername</Username>
            </Credentials>
            <Path>\\networkshare\share\data.wim</Path>
            <MetaData wcm:action="add">
                <Key>/IMAGE/NAME</Key>
                <Value>FabrikamData</Value>
            </MetaData>
        </InstallFrom>
        <Order>1</Order>
    </DataImage>
</ImageInstall>

OSImage

InstallToAvailablePartition