Share via


/add-Image

Applies To: Windows Server 2008, Windows Server 2008 R2

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

Syntax

For boot images, use the following syntax:

WDSUTIL /Add-Image /ImageFile:<wim file path> [/Server:<Server name>] /ImageType:Boot [/SkipVerify] [/Name:<Image name>] [/Description:<Image description>] 
[/Filename:<New wim file name>]

For install images, use the following syntax:

WDSUTIL /Add-Image /ImageFile:<wim file path>
     [/Server:<Server name>]
     /ImageType:Install
     [/SkipVerify]
     [/ImageGroup:<Image group name>]
     [/SingleImage:<Single image name>]
         [/Name:<Name>]
         [/Description:<Description>]
     [/Filename:<File name>]
     [/UnattendFile:<Unattend file path>]

Parameters

Parameter Description

/ImageFile:<.wim file path>

Specifies the full path and file name of the Windows Image (.wim) file that contains the images to be added.

[/Server:<Server name>]

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.

/ImageType:{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:<Name>]

Sets the display name of the image.

[/Description:<Description>]

Sets the description of the image.

[/Filename:<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.

[/ImageGroup:<Image group name>]

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:<Single image name>] [/Name:<Name>] [/Description:<Description>]

Copies the specified single image out of a .wim file, and sets the image's display name and description.

[/UnattendFile:<Unattend file path>]

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.

Examples

To add a boot image, type:

WDSUTIL /Add-Image /ImageFile:"C:\MyFolder\Boot.wim" /ImageType:Boot
WDSUTIL /Verbose /Progress /Add-Image /ImageFile:\\MyServer\Share\Boot.wim /Server:MyWDSServer /ImageType: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-Image /ImageFile:"C:\MyFolder\Install.wim" /ImageType:Install
WDSUTIL /Verbose /Progress /Add-Image /ImageFile:\\MyServer\Share \Install.wim /Server:MyWDSServer /ImageType:Install /ImageGroup: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 Key

/copy-Image

/export-Image

/get-Image

/remove-Image

/replace-Image

/set-Image