Share via

/new-CaptureImage

  • Article

Applies To: Windows Server 2008, Windows Server 2008 R2

Creates a new capture image from an existing boot image. Capture images are boot images that start the Windows Deployment Services capture utility instead of starting Setup. When you boot a reference computer (that has been prepared with Sysprep) into a capture image, a wizard creates an install image of the reference computer and saves it as a Windows Image (.wim) file. You can also add the image to media (such as a CD, DVD, or USB drive), and then boot a computer from that media. After you create the install image, you can add the image to the server for PXE boot deployment. For more information, see Creating Images (https://go.microsoft.com/fwlink/?LinkId=115311).

Syntax

WDSUTIL [Options] /New-CaptureImage [/Server:<Server name>]
     /Image:<Image name>
     /Architecture:{x86 | ia64 | x64}
     [/Filename:<File name>]
     /DestinationImage
        /FilePath:<File path and name>
        [/Name:<Name>]
        [/Description:<Description>]
        [/Overwrite:{Yes | No | Append}]
        [/UnattendFilePath:<File path>]

Parameters

Parameter Description

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

/Image:<Image name>

Specifies the name of the source boot image.

/Architecture: {x86 | ia64 | x64}

Specifies the architecture of the image to use. Because you can have the same image name for different boot images in different architectures, specifying this ensures the correct image is used.

[/Filename: <Filename>]

If the image cannot be uniquely identified by name, you must use this option to specify the file name.

/DestinationImage

Specifies the settings for the destination image. You specify the settings using the following options:

  • /FilePath: <File path and name> Sets the full file path for the new capture image.

  • [/Name: <Name>] - Sets the display name of the image. If no display name is specified, the display name of the source image will be used.

  • [/Description: <Description>] - Sets the description of the image.

  • [/Overwrite: {Yes | No | Append}] - Determines whether the file specified in /DestinationImage should be overwritten if another file with that name already exists at the /FilePath. Yes overwrites the existing file. No (default) causes an error to occur if another file with the same name already exists. Append attaches the generated image as a new image within the existing .wim file.

  • [/UnattendFilePath: <File path>] - Sets the full path and name for the unattended image capture file.

Examples

To create a capture image and name it WinPECapture.wim, type:

WDSUTIL /New-CaptureImage /Image:"WinPE boot image" /Architecture:x86 /DestinationImage /FilePath:"C:\Temp\WinPECapture.wim"

To create a capture image and apply the specified settings, type:

WDSUTIL /Verbose /Progress /New-CaptureImage /Server:MyWDSServer /Image:"WinPE boot image" /Architecture:x64 /Filename:boot.wim 
/DestinationImage /FilePath:"\\Server\Share\WinPECapture.wim" /Name:"New WinPE image" /Description:"WinPE image with capture utility" /Overwrite:No /UnattendFilePath:"\\Server\Share\WDSCapture.inf"

Additional references

Command-Line Syntax Key