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

Use the Key and Value settings together to select a Windows edition or image based on the index, the name, or the description of the image.

Use the DISM /Get-ImageInfo command to determine which images and editions are included on your Windows DVD or Windows image (.wim) file. For instructions on how to select a Windows image using the MetaData setting, see the Best Practices for Image Deployment topic in the Windows® Assessment and Deployment Kit (Windows ADK) Technical Reference.

Child Elements

Key

Specifies whether the image number, name, or description is used to select the image in a .wim file.

Value

Specifies the value of the Key setting.

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 ImageInstall setting to install a specific Windows image from the Windows DVD by using the image index value:

  Copy Code
<ImageInstall>
	<OSImage>
		<InstallFrom>
			<MetaData wcm:action="add">
				<Key>/IMAGE/INDEX</Key>
				<Value>2</Value>
			</MetaData>
		</InstallFrom>
		<InstallTo>
			<DiskID>0</DiskID>
			<PartitionID>3</PartitionID>
		</InstallTo>
	</OSImage>
</ImageInstall>

The following XML output shows how to configure the ImageInstall setting to install a specific Windows image from a custom Windows image file (.wim) located on a network share. Windows Setup selects the image from the LaptopImages.wim file by referencing the image description of a fictional laptop model named "Model FNB1".

  Copy Code
<ImageInstall>
	<OSImage>
		<InstallFrom>
			<Credentials>
				<Domain>FabrikamDomain</Domain>
				<Password>MyPassword</Password>
				<Username>MyUsername</Username>
			</Credentials>
			<Path>\\server\share\CustomWindowsImages\LaptopImages.wim</Path>
			<MetaData wcm:action="add">
				<Key>/IMAGE/DESCRIPTION</Key>
				<Value>Model FNB1</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