Edit

wdsutil replace-image

  • Article

Applies to: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012

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 | x64 | arm | arm64}
        [/Filename:<File name>]
        /ReplacementImage
          /ImageFile:<WIM file path>
          [/Name:<Image name>]
          [/Description:<Image description>]

/Architecture:{x86 | x64 | arm | arm64}
        The architecture of the image to be replaced. Since it is
        possible to have the same image name for boot images in
        different architectures, specifying the architecture value
        ensures that the correct image is replaced.

[/Filename:<File name>]
        If the image cannot be uniquely identified by name, the file
        name must be specified.

/ReplacementImage
  /ImageFile:<WIM file path>
        Specifies the full path and file name of the new WIM file.

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

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

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

[/ImageGroup:<Image group name>]
        The image group containing the image to be replaced. If not
        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, then the image group must be
        specified.

[/Filename:<File name>]
        If the image cannot be uniquely identified by name, the file
        name must be specified.

/ReplacementImage
  /ImageFile:<WIM file path>
        Specifies the full path and file name of the new WIM file.

  [/SourceImage:<image name>]
        Specifies the image to use if the new WIM file contains
        multiple images.

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

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

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 is used.
mediatype:{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's 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 can't 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:

- mediaFile: <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 10 Home"
/ImageType:Install /ReplacementImage /ImageFile:"C:\MyFolder\Install.wim"

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