MetaData specifies a data image in a Windows® image (.wim) file.

Use the MetaData\Key and MetaData\Value settings together to select an image based on the index, the name, or the description of the data image.

To determine what images are available to be installed

Use the DISM /Get-WimInfo command to determine which images and editions are included on your data image (.wim) file, such as in the following example:

  Copy Code
DISM /Get-WimInfo /WimFile:N:\Drivers\FNBDrivers.wim

Information about the available images will be displayed; for example:

  Copy Code
Deployment Image Servicing and Management tool
Version: 6.1.7108.0
 
Details for image : N:\Drivers\FNBDrivers.wim
 
Index : 1
Name : FNB1Drivers
Description : FabriKam Model FNB1 Drivers
Size : 1,234,567 bytes
 
Index : 2
Name : FNB2Drivers
Description : FabriKam Model FNB2 Drivers
Size : 2,234,567 bytes
 
Index : 3
Name : FNB3Drivers
Description : FabriKam Model FNB3 Drivers
Size : 3,234,567 bytes

Child Elements

Key

Required. Specifies whether the image index, name, or description is used to specify the metadata for an image in a .wim file.

Value

Required. Specifies the value of the Key element for the data image.

Valid Configuration Passes

windowsPE

Parent Hierarchy

Applies To

For a list of the Windows editions and architectures that this component supports, see Microsoft-Windows-Setup.

XML Examples

The following XML output shows how to configure the DataImage setting to install a specific data image from a custom .wim file located on a network share using the image index value.

  Copy Code
<ImageInstall>
	<DataImage>
		<InstallFrom>
			<Credentials>
				<Domain>FabrikamDomain</Domain>
				<Password>MyPassword</Password>
				<Username>MyUsername</Username>
			</Credentials>
			<Path>\\networkshare\share\Drivers\FNBDrivers.wim </Path>
			<MetaData wcm:action="add">
				<Key>/IMAGE/INDEX</Key>
				<Value>1</Value>
			</MetaData>
		</InstallFrom>
		<InstallTo>
			<DiskID>0</DiskID>
			<PartitionID>3</PartitionID>
		</InstallTo>
		<WillShowUI>OnError</WillShowUI>
	</DataImage>
</ImageInstall>

The following XML output shows how to configure the MetaData setting to install a specific data image using the image name.

  Copy Code
<ImageInstall>
	<DataImage>
		<InstallFrom>
			<Credentials>
				<Domain>FabrikamDomain</Domain>
				<Password>MyPassword</Password>
				<Username>MyUsername</Username>
			</Credentials>
			<Path>\\networkshare\share\Drivers\FNBDrivers.wim </Path>
			<MetaData wcm:action="add">
				<Key>/IMAGE/NAME</Key>
				<Value>FNB2Drivers</Value>
			</MetaData>
		</InstallFrom>
		<InstallTo>
			<DiskID>0</DiskID>
			<PartitionID>3</PartitionID>
		</InstallTo>
		<WillShowUI>OnError</WillShowUI>
	</DataImage>
</ImageInstall>

The following XML output shows how to configure the MetaData setting to install a specific data image from a custom .wim file located on a network share using the image description.

  Copy Code
<ImageInstall>
	<OSImage>
		<InstallFrom>
			<Credentials>
				<Domain>FabrikamDomain</Domain>
				<Password>MyPassword</Password>
				<Username>MyUsername</Username>
			</Credentials>
			<Path>\\networkshare\share\Drivers\FNBDrivers.wim </Path>
			<MetaData wcm:action="add">
				<Key>/IMAGE/DESCRIPTION</Key>
				<Value>FabriKam Model FNB3 Drivers</Value>
			</MetaData>
		</InstallFrom>
		<InstallTo>
			<DiskID>0</DiskID>
			<PartitionID>3</PartitionID>
		</InstallTo>
		<WillShowUI>OnError</WillShowUI>
		<InstallToAvailablePartition>false</InstallToAvailablePartition>
	</OSImage>
</ImageInstall>

See Also

Concepts

InstallFrom
Key
Value