Share via

wdsutil replace-image

  • Artigo

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2 e Windows Server 2012

Substitui uma imagem existente por uma nova versão dessa imagem.

Syntax

para imagens de inicialização:

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 imagens de instalação:

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 Descrição
/Image:<Image name> Especifica o nome da imagem a ser adicionada.
[/Server:<nome do servidor>] Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome de domínio totalmente qualificado). Se nenhum nome do servidor for especificado, o servidor local será usado.
mediatype:{Boot | Install} Especifica o tipo da imagem a ser substituída.
/Architecture:{x86 | ia64 | x64} Especifica a arquitetura da imagem a ser substituída. Como é possível ter o mesmo nome de imagem para as imagens de inicialização diferentes em arquiteturas diferentes, especificar a arquitetura garante que a imagem correta seja substituída.
[/Filename:<File name>] se a imagem não puder ser identificada exclusivamente pelo nome, você deverá usar essa opção para especificar o nome de arquivo.
/replacementImage Especifica as configurações para a imagem de substituição. Defina as configurações usando as seguintes opções:

- mediaFile: <caminho do arquivo> - especifica o nome e o local (caminho completo) do novo arquivo .wim.
- [/SourceImage: <nome da imagem>] - especifica a imagem a ser usada se o arquivo .wim contiver várias imagens. Essa opção se aplica apenas às imagens de instalação.
- [/Name:<Nome da imagem>] - define o nome de exibição da imagem.
- [/Description:<Descrição da imagem>] - define a descrição da imagem.

Exemplos

Para substituir uma imagem de inicialização, digite uma das seguintes opções:

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 substituir uma imagem de inicialização, digite uma das seguintes opções:

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