This documentation is archived and is not being maintained.

Key

Key specifies the absolute hierarchical path to a key specified as part of the metadata for an image in a Windows image (.wim) file.

The following examples show how the Key and Value settings in the MetaData setting are combined to describe metadata information.

Sample .wim metadata output:

<WIM>
   <IMAGE INDEX="1">
      <NAME>FabrikamWIM</NAME>
      <DESCRIPTION>FabrikamCustomWindowsImage</DESCRIPTION>
   </IMAGE>
</WIM>

The following table shows the Key and Value pairs that should be used to correspond to the metadata in the sample .wim file output.

 

Key Value

/IMAGE/INDEX

1

/IMAGE/NAME

FabrikamWIM

/IMAGE/DESCRIPTION

FabrikamCustomWindowsImage

For more information about how the Key and Value settings are combined, see the MetaData setting.

Values

 

Absolute_path_to_an_image

Specifies the absolute hierarchical path to a key specified as part of the metadata for an image in a .wim file. Absolute_path_to_an_image is a string.

With ImageX, you can see the index, the name, and the flags associated with multiple images in a .wim file.

This string type does not support empty elements. Do not create an empty value for this setting.

Valid Passes

Parent Hierarchy

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

MetaData

Show: