InstallToAvailablePartition

  • Article

InstallToAvailablePartition specifies whether to install the Windows operating system to the first available partition that has enough space and does not already contain an installation of Windows.

Warning

If you specify a location to install Windows in InstallTo, do not set InstallToAvailablePartition.

If you are installing Windows to a blank disk, you must create and format partitions with the CreatePartitions and ModifyPartitions settings. After the partitions are created and formatted, InstallToAvailablePartition will select the first available partition with enough space to install Windows.

Note

If InstallToAvailablePartition is set to true, InstallTo is specified, and WillShowUI is set to Never, an error is logged, and installation is terminated.

Values

true

Specifies that Windows is installed to the first available partition with enough space.

Windows Setup searches for available partitions starting with disk 0 and partition 1 on the first disk and continuing through all available disks.

false

Specifies that Windows is not installed to the first available partition. This is the default value.

If InstallToAvailablePartition is set to false, you must specify the hard disk and partition to install Windows to, by using InstallTo.

Valid Passes

windowsPE

Parent Hierarchy

Microsoft-Windows-Setup | ImageInstall | OSImage | InstallToAvailablePartition

Applies To

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

See Also

Concepts

OSImage