Share via

/replace-Image

  • Article

Applies To: Windows Server 2008, Windows Server 2008 R2

Replaces an existing image with a new version of that image.

Syntax

For boot images:

WDSUTIL [Options] /Replace-Image /Image:<Image name> [/Server:<Server name>]
     /ImageType:Boot
     /Architecture:{x86 | ia64 | x64}
     [/Filename:<File name>]
     /ReplacementImage
         /ImageFile:<wim file path>
         [/Name:<Image name>]
         [/Description:<Image description>]

For install images:

WDSUTIL [Options] /Replace-Image /Image:<Image name> [/Server:<Server name>]
     /ImageType:Install
     [/ImageGroup:<Image group name>]
     [/Filename:<File name>]
     /ReplacementImage
         /ImageFile:<wim file path>
         [/SourceImage:<Source image name>]
         [/Name:<Image name>]
         [/Description:<Image description>]

Parameters

Parameter Description

/Image:<Image name>

Specifies the name of the image to be replaced.

[/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 replaced.

/Architecture:{x86 | ia64 | x64}

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

[/Filename:<File name>]

If the image cannot be uniquely identified by name, you must use this option to specify the file name.

/ReplacementImage

Specifies the settings for the replacement image. You set these settings using the following options:

  • /ImageFile: <file path> - Specifies the name and location (full path) of the new .wim file.

  • [/SourceImage: <image name>] - Specifies the image to be used if the .wim file contains multiple images. This option applies only to install images.

  • [/Name:<Image name>] – Sets the display name of the image.

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

Examples

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

WDSUTIL /Replace-Image /Image:"WinPE Boot Image" /ImageType:Boot /Architecture:x86 /ReplacementImage /ImageFile:"C:\MyFolder\Boot.wim"
WDSUTIL /Verbose /Progress /Replace-Image /Image:"WinPE Boot Image" /Server:MyWDSServer /ImageType:Boot /Architecture:x64 /Filename:boot.wim 
/ReplacementImage /ImageFile:\\MyServer\Share\Boot.wim /Name:"My WinPE Image" /Description:"WinPE Image with drivers"

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

WDSUTIL /Replace-Image /Image:"Windows Vista Home" /ImageType:Install /ReplacementImage /ImageFile:"C:\MyFolder\Install.wim"
WDSUTIL /Verbose /Progress /Replace-Image /Image:"Windows Vista Pro" /Server:MyWDSServer /ImageType:Install /ImageGroup:ImageGroup1 
/Filename:Install.wim /ReplacementImage /ImageFile:\\MyServer\Share \Install.wim /SourceImage:"Windows Vista Ultimate" /Name:"Windows Vista Desktop" /Description:"Windows Vista Ultimate with standard business applications."

Additional references

Command-Line Syntax Key

/add-Image

/copy-Image

/export-Image

/get-Image

/replace-Image

/set-Image