wdsutil set-image

  • Artigo

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

Altera os atributos de uma imagem.

Syntax

para imagens de inicialização:

wdsutil /Set-Imagmedia:<Image name> [/Server:<Server name>mediatype:Boot /Architecture:{x86 | ia64 | x64} [/Filename:<File name>] [/Name:<Name>]
[/Description:<Description>] [/Enabled:{Yes | No}]

para imagens de instalação:

wdsutil /Set-Imagmedia:<Image name> [/Server:<Server name>]
   mediatype:InstallmediaGroup:<Image group name>]
     [/Filename:<File name>]
     [/Name:<Name>]
     [/Description:<Description>]
     [/UserFilter:<SDDL>]
     [/Enabled:{Yes | No}]
     [/UnattendFile:<Unattend file path>]
         [/OverwriteUnattend:{Yes | No}]

Parâmetros

Parâmetro Descrição
media:<Image name> Especifica o nome da imagem.
[/Server:<Server name>] 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 de imagem.
/Architecture:{x86 | ia64 | x64} Especifica a arquitetura da imagem. Como é possível ter o mesmo nome de imagem para diferentes imagens de inicialização em diferentes arquiteturas, especificar a arquitetura garante que a imagem correta seja modificada.
[/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.
[/Name] Especifica o nome da imagem.
[/Description:<Description>] Especifica a descrição da imagem.
[/Enabled:{Yes | No}] Habilita ou desabilita a imagem.
\mediaGroup:<Image group name>] Especifica o grupo de imagens que contém a imagem. Se nenhum nome do grupo de imagens for especificado e apenas um grupo existir no servidor, esse grupo será usado. Se houver mais de um grupo de imagens no servidor, você deverá usar essa opção para especificar o grupo de imagens.
[/UserFilter:<SDDL>] Define o filtro do usuário na imagem. A cadeia de caracteres de filtro deve estar no formato SDDL (Linguagem de Definição de Descritor de Segurança). Observe que, ao contrário da opção /Security para grupos de imagens, essa opção restringe apenas quem pode ver a definição de imagem e não os recursos reais do arquivo de imagem. Para restringir o acesso aos recursos de arquivo e, portanto, acessar todas as imagens em um grupo de imagens, você precisará definir a segurança para o próprio grupo de imagens.
[/UnattendFile:<Unattend file path>] Define o caminho completo para o arquivo autônomo a ser associado à imagem. Por exemplo: D:\Files\Unattend\Img1Unattend.xml
[/OverwriteUnattend:{Yes | No}] Você pode especificar /Overwrite para substituir o arquivo autônomo, se já houver um arquivo autônomo associado à imagem. Observe que a configuração padrão é Não.

Exemplos

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

wdsutil /Set-Imagmedia:WinPE boot imagemediatype:Boot /Architecture:x86 /Description:New description
wdsutil /verbose /Set-Imagmedia:WinPE boot image /Server:MyWDSServemediatype:Boot /Architecture:x86 /Filename:boot.wim
/Name:New Name /Description:New Description /Enabled:Yes

Para definir valores para uma imagem de instalação, digite uma das seguintes opções:

wdsutil /Set-Imagmedia:Windows Vista with Officemediatype:Install /Description:New description
wdsutil /verbose /Set-Imagmedia:Windows Vista with Office /Server:MyWDSServemediatype:InstalmediaGroup:ImageGroup1
/Filename:install.wim /Name:New name /Description:New description /UserFilter:O:BAG:DUD:AI(A;ID;FA;;;SY)(A;ID;FA;;;BA)(A;ID;0x1200a9;;;AU) /Enabled:Yes /UnattendFile:\\server\share\unattend.xml /OverwriteUnattend:Yes