Share via

wdsutil replace-image

  • Artículo

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2 y Windows Server 2012.

Reemplaza una imagen existente por una nueva versión de esa imagen.

Sintaxis

para imágenes de arranque:

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.

para imágenes de instalación:

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.

Parámetros

Parámetro Descripción
/image:<Nombre de la imagen> Especifica el nombre de la imagen que se va a reemplazar.
[/Server:<Server name>] Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el nombre de dominio completo (FQDN). Si no se especifica el nombre del servidor, se usará el servidor local.
mediatype:{Boot | Install} Especifica el tipo de imagen que se va a reemplazar.
/Architecture:{x86 | ia64 | x64} Especifica la arquitectura de la imagen que se va a reemplazar. Dado que es posible tener el mismo nombre de imagen para diferentes imágenes de arranque en arquitecturas diferentes, especificar la arquitectura garantiza que se reemplace la imagen correcta.
[/Filename:<Nombre de archivo>] Si la imagen no se puede identificar de forma única por nombre, debe usar esta opción para especificar el nombre de archivo.
/replacementImage Especifica la configuración de la imagen de reemplazo. Esta configuración se establece con las siguientes opciones:

- mediaFile: <file path>: especifica el nombre y la ubicación (ruta de acceso completa) del nuevo archivo .wim.
- [/SourceImage: <image name>]: especifica la imagen que se va a usar si el archivo .wim contiene varias imágenes. Esta opción solo se aplica a imágenes de instalación.
- [/Name:<Image name>] establece el nombre para mostrar de la imagen.
- [/Description:<Image description>]: establece la descripción de la imagen.

Ejemplos

Para reemplazar una imagen de arranque, escriba una de las siguientes opciones:

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"

Para reemplazar una imagen de instalación, escriba una de las siguientes opciones:

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