DataImage specifies a data image to install. You can add additional data on top of a Windows operating system image, by using a data image. Data images can include applications, device drivers, and other configuration files. You can create a data image, by using ImageX.

You should never use a data image to overwrite Windows system data. Use data images only to add files.

There can be more than one data image. The OSImage is installed before any data images.

Note
The MetaData settings are required.

Child Elements

InstallFrom

Required. Specifies the location from which to install the data image.

InstallTo

Required. Specifies the location to which to install the data image.

Order

Required. Specifies the order in which to install the data image.

Valid Configuration Passes

windowsPE

Parent Hierarchy

Applies To

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

Concepts

ImageInstall