Changes the attributes of the specified image.
Syntax
For boot images:
WDSUTIL /Set-Image /Image:<Image name> [/Server:<Server name>] /ImageType:Boot /Architecture:{x86 | ia64 | x64} [/Filename:<File name>] [/Name:<Name>] [/Description:<Description>] [/Enabled:{Yes | No}]
For install images:
WDSUTIL /Set-Image /Image:<Image name> [/Server:<Server name>] /ImageType:Install [/ImageGroup:<Image group name>] [/Filename:<File name>] [/Name:<Name>] [/Description:<Description>] [/UserFilter:<SDDL>] [/Enabled:{Yes | No}] [/UnattendFile:<Unattend file path>] [/OverwriteUnattend:{Yes | No}]
Parameters
Parameter | Description |
---|---|
/Image:<Image name> |
Specifies the name of the image to be modified. |
[/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 modified. |
/Architecture:{x86 | ia64 | x64} |
Specifies the architecture of the image to be modified. Because you can have the same image name for different boot images in different architectures, specifying the architecture ensures that the correct image is modified. |
[/Filename:<File name>] |
If the image cannot be uniquely identified by name, you must use this option to specify the file name. |
[/Name] |
Specifies the name of the image to be modified. |
[/Description:<Description>] |
Sets the description of the image to be modified. |
[/Enabled:{Yes | No}] |
Sets the image as either enabled or disabled. |
[/ImageGroup:<Image group name>] |
Specifies the image group that contains the image to be modified. If no image group name is specified and only one image group exists on the server, that image group will be used. If more than one image group exists on the server, you must use this option to specify the image group. |
[/UserFilter:<SDDL>] |
Sets the user filter on the image. The filter string must be in Security Descriptor Definition Language (SDDL) format. Note that, unlike the /Security option for image groups, this option only restricts who can see the image definition, and not the actual image file resources. To restrict access to the file resources, and therefore access to all images within an image group, you will need to set security for the image group itself. |
[/UnattendFile:<Unattend file path>] |
Sets the full path to the unattend file to be associated with the image. For example: D:\Files\Unattend\Img1Unattend.xml |
[/OverwriteUnattend:{Yes | No}] |
You can specify /Overwrite to overwrite the unattend file if there is already an unattend file associated with the image. Note that the default setting is No. |
Examples
To set values for a boot image, type:
WDSUTIL /Set-Image /Image:"WinPE boot image" /ImageType:Boot /Architecture:x86 /Description:"New description" WDSUTIL /Verbose /Set-Image /Image:"WinPE boot image" /Server:MyWDSServer /ImageType:Boot /Architecture:x86 /Filename:boot.wim /Name:"New Name" /Description:"New Description" /Enabled:Yes
To set values for an install image, type:
WDSUTIL /Set-Image /Image:"Windows Vista with Office" /ImageType:Install /Description:"New description" WDSUTIL /Verbose /Set-Image /Image:"Windows Vista with Office" /Server:MyWDSServer /ImageType:Install /ImageGroup: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