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

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.

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