DataImage

  • Article

DataImage specifies a data image to install. You can add 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

Setting Description
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

Microsoft-Windows-Setup | ImageInstall | DataImage

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.

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

ImageInstall

Create a Data Image using DISM