InstallTo

Article
02/10/2014

Applies To: Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Vista

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

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