Table of contents
Collapse the table of content
Expand the table of content

Using the add-Image Command

Corey Plett|Last Updated: 11/16/2016

Applies To: Windows Server 2016, Windows Server 2012 R2, Windows Server 2012

adds images to a Windows Deployment Services server. For examples of how you can use this command, see Examples.


for boot images, use the following syntax:

wdsutil /add-ImagmediaFile:<wim file path> [/Server:<Server name>mediatype:Boot [/Skipverify] [/Name:<Image name>] [/Description:<Image description>] 
[/Filename:<New wim file name>]

for install images, use the following syntax:

wdsutil /add-ImagmediaFile:<wim file path>
     [/Server:<Server name>]
    mediaGroup:<Image group name>]
     [/SingleImage:<Single image name>]
     [/Filename:<File name>]
     [/UnattendFile:<Unattend file path>]


mediaFile:<.wim file path>Specifies the full path and file name of the Windows Image (.wim) file that contains the images to be added.
[/Server:]Specifies the name of the server. This can be either the NetBIOS name or the fully qualified domain name (FQDN). If a server name is not specified, the local server will be used.
mediatype:{Boot|Install}Specifies the type of images to be added.
[/Skipverify]Specifies that integrity verification will not be performed on the source image file before the image is added.
[/Name:]Sets the display name of the image.
[/Description:]Sets the description of the image.
[/Filename:]Specifies the new file name for the .wim file. This enables you to change the file name of the .wim file when adding the image. If no file name is specified, the source image file name will be used. In all cases, Windows Deployment Services checks to determine whether the file name is unique in the boot image store of the destination computer.
\mediaGroup:]Specifies the name of the image group in which the images are to be added. If more than one image group exists on the server, the image group must be specified. If this is not specified and an image group does not already exist, a new image group will be created. Otherwise, the existing image group will be used.
[/SingleImage:] [/Name:] [/Description:]Copies the specified single image out of a .wim file, and sets the image's display name and description.
[/UnattendFile:]Specifies the full path to the unattended installation file to be associated with the images that are being added. If /SingleImage is not specified, the same unattend file will be associated with all of the images in the .wim file.


To add a boot image, type:

wdsutil /add-ImagmediaFile:"C:\MyFolder\Boot.wimmediatype:Boot
wdsutil /verbose /Progress /add-ImagmediaFile:\\MyServer\Share\Boot.wim /Server:MyWDSServemediatype:Boot /Name:"My WinPE Image" 
/Description:"WinPE Image containing the WDS Client" /Filename:WDSBoot.wim

To add an install image, type one of the following:

wdsutil /add-ImagmediaFile:"C:\MyFolder\Install.wimmediatype:Install
wdsutil /verbose /Progress /add-ImagmediaFile:\\MyServer\Share \Install.wim /Server:MyWDSServemediatype:InstalmediaGroup:ImageGroup1 
/SingleImage:"Windows Professional" /Name:"My WDS Image"
/Description:"Windows Professional image with MSOffice" /Filename:"Win Pro.wim" /UnattendFile:"\\server\share\unattend.xml"

additional references

Command-Line Syntax KeyUsing the copy-Image CommandUsing the Export-Image CommandUsing the get-Image CommandUsing the remove-Image CommandUsing the replace-Image CommandSubcommand: set-Image

© 2017 Microsoft