Share via

/export-Image

  • Article

Applies To: Windows Server 2008, Windows Server 2008 R2

Exports an existing image from the image store to another Windows Image (.wim) file.

Syntax

For boot images:

WDSUTIL [Options] /Export-Image /Image:<Image name> [/Server:<Server name>]
     /ImageType:Boot /Architecture:{x86 | ia64 | x64} [/Filename:<File name>]
     /DestinationImage
         /Filepath:<File path and name>
         [/Name:<Name>]
         [/Description:<Description>]
     [/Overwrite:{Yes | No}]

For install images:

WDSUTIL [Options] /Export-Image /Image:<Image name> [/Server:<Server name>]
     /ImageType:Install [/ImageGroup:<Image group name>]
     [/Filename:<File name>]
     /DestinationImage
         /Filepath:<File path and name>
         [/Name:<Name>]
         [/Description:<Description>]
     [/Overwrite:{Yes | No | Append}]

Parameters

Parameter Description

/Image:<Image name>

Specifies the name of the image to be exported.

[/Server:<Server name>]

Specifies the name of the server. This can be either the NetBIOS name or the fully qualified domain name (FQDN). If no server name is specified, the local server will be used.

/ImageType:{Boot | Install}

Specifies the type of image to be exported.

[/ImageGroup:<Image group name>]

Specifies the image group containing the image to be exported. If no image group name is specified and only one image group exists on the server, that image group will be used by default. If more than one image group exists on the server, the image group must be specified.

/Architecture:{x86 | ia64 | x64}

Specifies the architecture of the image to be exported. Because it is possible to have the same image name for boot images in different architectures, specifying the architecture value ensures that the correct image will be returned.

[/Filename:<Filename>]

If the image cannot be uniquely identified by name, the file name must be specified.

/DestinationImage

Specifies the settings for the destination image. You can specify these settings using the following options:

  • /FilePath:<File path and name> - Specifies the full file path for the new image.

  • [/Name:<Name>] - Sets the display name of the image. If no name is specified, the display name of the source image will be used.

  • [/Description: <Description>] - Sets the description of the image.

[/Overwrite:{Yes | No | Append}]

Determines whether the file specified in the /DestinationImage option will be overwritten if an existing file with that name already exists at the /FilePath.

  • Yes causes the existing file to be overwritten.

  • No (the default option) causes an error to occur if a file with the same name already exists.

  • Append causes the generated image to be appended as a new image within the existing .wim file.

Examples

To export a boot image, type one of the following:

WDSUTIL /Export-Image /Image:"WinPE boot image" /ImageType:Boot /Architecture:x86 /DestinationImage /FilePath:"C:\temp\boot.wim"
WDSUTIL /Verbose /Progress /Export-Image /Image:"WinPE boot image" /Server:MyWDSServer /ImageType:Boot /Architecture:x64 /Filename:boot.wim 
/DestinationImage /FilePath:"\\Server\Share\ExportImage.wim" /Name:"Exported WinPE image" /Description:"WinPE Image from WDS server" /Overwrite:Yes

To export an install image, type one of the following:

WDSUTIL /Export-Image /Image:"Windows Vista with Office" /ImageType:Install /DestinationImage /FilePath:"C:\Temp\Install.wim"
WDSUTIL /Verbose /Progress /Export-Image /Image:"Windows Vista with Office" /Server:MyWDSServer /ImageType:Install /ImageGroup:ImageGroup1 
/Filename:install.wim /DestinationImage /FilePath:\\server\share\export.wim /Name:"Exported Windows image" /Description:"Windows Vista image from WDS server" /Overwrite:Append

Additional references

Command-Line Syntax Key

/add-Image

/copy-Image

/get-Image

/remove-Image

/replace-Image

/set-Image