This topic contains procedures for the tasks that are listed and described in the following table.

Note

Help for WDSUTIL is available by typing WDSUTIL /? at a command prompt or online at http://go.microsoft.com/fwlink/?LinkId=112194.
Type Procedure

General Tasks

  • To export an image from the server to a stand-alone .wim file

  • To replace an image on the server with an updated version

  • To remove an image

Boot Images

  • To add a boot image to the server

  • To set attributes on a boot image

  • To display the attributes of a boot image

  • To create a capture image

  • To create a discover image

Install Images

  • To add an install image

  • To set the attributes on an install image

  • To display the attributes on an install image

  • To convert an RIPREP image to a .wim install image

  • To make a copy of an install image within an image group

Image Groups

  • To remove an image group

  • To add an image group to the image store

  • To set the attributes on an image group

  • To display information about all images in an image group

General Tasks

To export an image from the server to a stand-alone .wim file

Using the MMC Using WDSUTIL
  1. Right-click a boot or install image, and then click Export Image.

  2. In the dialog box, choose a file name to export the image to.
  1. Click Start, right-click Command Prompt, and click Run as administrator.

  2. Do one of the following:

    • For a boot image, run WDSUTIL /Verbose /Progress /Export-Image /Image:<name> /ImageType:Boot /Architecture:{x86|x64|ia64} /DestinationImage /Filepath:<path and file name>.

    • For an install image, run WDSUTIL /Verbose /Progress /Export-Image /Image:<name> /ImageType:Install /ImageGroup:<image group name> /DestinationImage /Filepath:<path and file name>.

  3. You can also set the following:

    • To set these metadata fields on the image, append /Name:<name> or /Description:<description>

    • To determine behavior when the image specified in /DestinationImage already exists, append /Overwrite:{Yes|No|Append}. Yes will overwrite the image, No will cause an error, and Append will append the new image to the existing .wim file. Note that Append is available only for install images.

The preceding procedure does the following:

  • For a boot image, it copies the file to the specified destination.

  • For an install image, it combines the metadata in the Install.wim file with the resources in the Res.rwm file into a single .wim file at the specified destination.

To replace an image on the server with an updated version

Using the MMC Using WDSUTIL
  1. Right-click a boot or install image, and then click Replace Image.

  2. Browse to the updated version.

  3. Click through the rest of the wizard.
  1. Click Start, right-click Command Prompt, and click Run as administrator.

  2. Do one of the following:

    • To replace a boot image, run WDSUTIL /Verbose /Progress /Replace-Image /Image:<name> /ImageType:Boot /Architecture:{x86|x64|ia64} /ReplacementImage /ImageFile:<path>.

    • To replace an install image, run WDSUTIL /Verbose /Progress /Replace-Image /Image:<name> /ImageType:Install /ImageGroup:<image group name> /ReplacementImage /ImageFile:<path>.

The preceding procedure adds the new image to the image store and removes the old one.

To remove an image

Using the MMC Using WDSUTIL
  1. Right-click a boot or install image.

  2. Click Delete.
  1. Click Start, right-click Command Prompt, and click Run as administrator.

  2. Do one of the following:

    • For boot images, run WDSUTIL /Remove-Image /Image:<name> /ImageType:Boot /Architecture:{x86|x64|ia64}

    • For install images, run WDSUTIL /Remove-Image /Image:<name> /ImageType:Install /ImageGroup:<image group name>. If the source image file contains more than one install image, append /SourceImage:<Source image name> to specify the image to use as a replacement.

The preceding procedure deletes the .wim image file from the image store.

Note

If you specify /SourceImage, data folders associated with the original image (for example, folders that contains unattend files or language packs) will be kept intact and will be associated with the replacement image.

Boot Images

To add a boot image to the server

Using the MMC Using WDSUTIL
  1. Right-click the Boot Images node, and then click Add Boot Image.

  2. Enter the path to the boot image or browse to the image file, and then click Next. In most cases, you should use the standard boot image that is included on the Windows Server 2008 media (located at \Sources\boot.wim) without modification. Do not use the Boot.wim from the Windows Vista media unless your version of Windows Vista has SP1 integrated into the DVD.

  3. Enter an image name and description, and then click Next.

  4. Review the choices, and then click Next.
  1. Click Start, right-click Command Prompt, and click Run as administrator.

  2. Run WDSUTIL /Verbose /Progress /Add-Image /ImageFile:<path> /ImageType:Boot, where the path is a full path to the image file.

The preceding procedure does the following:

  • Copies the boot image file to the folder \RemoteInstall\Boot\architecture\Images.

  • Generates a Boot Configuration Data (BCD) store for the boot image in the folder \RemoteInstall\Boot\ architecture \Images.

  • Generates a combined BCD store for the architecture in folder \RemoteInstall\Boot\ architecture.

  • Extracts the required files for Pre-Boot Execution Environment (PXE) booting from \Windows\Boot\PXE in the image to the folder \RemoteInstall\Boot. If the files already exist on the server, a version check is performed so that the newest files are used.

To set the attributes on a boot image

Using the MMC Using WDSUTIL
  1. Right-click a boot image, and then click Disable to take the image offline.

  2. Right-click the image, and then click Properties.

  3. Enter the name and description.
  1. Click Start, right-click Command Prompt, and click Run as administrator.

  2. Do one of the following:

    • To take the image offline, run WDSUTIL /Set-Image /Image:<name> /ImageType:Boot /Architecture:<arch> /Enabled:No.

    • To change the name and description, run WDSUTIL /Set-Image /Image:<name> /ImageType:Boot /Architecture:<arch> /Name:<name> /Description:<description>.

In the preceding procedure, note the following:

  • Taking an image offline sets the hidden file attribute on the relevant .wim file.

  • Changing the name and description changes these attributes in the metadata header of the .wim file.

To display the attributes of a boot image

Using the MMC Using WDSUTIL
  1. Right-click a boot image.

  2. Click Properties.
  1. Click Start, right-click Command Prompt, and click Run as administrator.

  2. Run WDSUTIL /Get-Image /Image:<name> /ImageType:Boot /Architecture:<arch>.

The preceding procedure displays the file name, image name, description, architecture, image type, size, creation and modify dates, default languages, operating system version, service pack level, and online and offline status of the image.

To create a capture image

Using the MMC Using WDSUTIL
  1. In the Windows Deployment Services MMC snap-in, expand the Boot Images node.

  2. Right-click the image to use it as a capture image (most commonly, the \Sources\boot.wim file from the installation media).

  3. Click Create Capture Boot Image.

  4. Type a name, description, and the location where you want to save a local copy of the file. You must specify a location so that if there is a network issue when you deploy the capture image, you have a local copy.

  5. Continue to follow the instructions in the wizard, and when it is completed, click Finish.

  6. Right-click the boot image folder.

  7. Click Add Boot Image.

  8. Browse and select the new capture image, and then click Next.

  9. Follow the instructions in the Image Capture Wizard.
  1. Click Start, right-click Command Prompt, and click Run as administrator.

  2. Run WDSUTIL /New-CaptureImage /Image:<source boot image name> /Architecture:{x86|ia64|x64} /DestinationImage /FilePath:<file path>, where the file path is the path and name for the capture image.

To create a discover image

Using the MMC Using WDSUTIL
  1. In the Windows Deployment Services MMC snap-in, expand the Boot images node.

  2. Right-click the image you want to use as a discover image. In most cases, this should be the Boot.wim file from the \Sources directory of the installation DVD.

  3. Click Create Discover Boot Image.

  4. Follow the instructions in the wizard, and when it is completed, click Finish.
  1. Click Start, right-click Command Prompt, and click Run as administrator.

  2. Run WDSUTIL /New-DiscoverImage /Image:<name> /Architecture:{x86|x64|ia64} /DestinationImage /FilePath:<path and name to new file>. To specify which server the discover image connects to, append /WDSServer:<server name or IP>.

Install Images

To add an install image

Using the MMC Using WDSUTIL
  1. Right-click the image group, and then click Add Install Image.

  2. Select an image group.

  3. Select the file to add.

  4. Proceed through the rest of the wizard.
  1. Click Start, right-click Command Prompt, and click Run as administrator.

  2. To create an image group, run WDSUTIL /Add-ImageGroup /ImageGroup:<image group name>.

  3. Run WDSUTIL /Verbose /Progress /Add-Image /ImageFile:<path to .wim file> /ImageType:Install.

    If more than one image group exists on the server, append /ImageGroup:<image group name> to specify which group the image should be added to.

    To skip the integrity check before adding the image, append /SkipVerify.

The preceding procedure runs an integrity check on the specified image file, creates a metadata-only .wim file in the image group folder, and adds the resources in the image file to the Resource .wim (res.rwm) file for the image group.

To set the attributes for an install image

The following procedure sets the name, description, online and offline status, access controls, and associated unattend file for an image.

Using the MMC Using WDSUTIL
  1. Right-click an install image, and then either click Disable to take the image offline or click Enable to bring it back online.

  2. On the Action menu, click Properties.

  3. Enter the name and description in the appropriate text boxes.

  4. Check Allow image to install in unattended mode, and then select a file to associate an unattend file with the install image.

  5. Use the Security tab to set access controls.
  1. Click Start, right-click Command Prompt, and click Run as administrator.

  2. Run WDSUTIL /Set-Image Image:<name> /ImageType:Install /ImageGroup:<image group name> /Name:<name> /Description:<description> /UserFilter:<SDDL> /Enabled:{Yes|No} /UnattendFile:<path>.

The preceding procedure changes image metadata or file access control lists (ACLs) on the image file to store the attributes. If you specify an unattend file, this procedure also copies it into the image store. Note that taking an image offline makes the file hidden.

To display the attributes for an install image

Using the MMC Using WDSUTIL
  1. Right-click the image.

  2. Click Properties.
  1. Click Start, right-click Command Prompt, and click Run as administrator.

  2. Run WDSUTIL /Get-Image /Image:<name> /ImageType:Install /ImageGroup:<image group name>.

The preceding procedure displays the file name, image name, description, architecture, image type, image group, size, HAL type, creation and modification time, languages, operating system version, ACLs, unattend file (if assigned), and the online or offline status of the image.

To convert a RIPREP image to a .wim install image

For more information, see Creating Images.

Using the MMC Using WDSUTIL
  1. Click the Legacy Images node.

  2. Right-click the RIPREP image you want to convert, and then click Convert to WIM.

  3. Enter the name, description, path, and file name, and then click Next.
  1. Click Start, right-click Command Prompt, and click Run as administrator.

  2. Run WDSUTIL /Verbose /Progress /Convert-RiPrepImage /FilePath:<path to RIPREP image sif file> /DestinationImage /FilePath:<path and name of .wim image>. In addition, you can specify the following:

    • To give the new .wim image a name in the metadata, append /Name:<name>.

    • To give the new .wim image a description in the metadata, append /Description:<description>.

    • To convert the original RIPREP image, rather than a copy, append /InPlace.

    • To determine behavior when the image file specified in /DestinationImage already exists, append /Overwrite:{Yes|No|Append}. Yes will overwrite the .wim file, No will cause an error, and Append will append the new image to the existing .wim file.

To make a copy of an install image

Using the MMC Using WDSUTIL

N/A
  1. Click Start, right-click Command Prompt, and click Run as administrator.

  2. Run WDSUTIL /Copy-Image /Image:<name> /ImageType:Install /ImageGroup:<image group name> /DestinationImage /Name:<name> /Filename:<file name>. To give the new image a description, append /Description:<description>.

The preceding procedure creates a copy of the metadata .wim file that corresponds to the selected image, and it sets the image name and file name (and description, if specified) to the values you specify.

Image Groups

To remove an image group

Using the MMC Using WDSUTIL
  1. Right-click image group.

  2. Click Delete.
  1. Click Start, right-click Command Prompt, and click Run as administrator.

  2. Run WDSUTIL /Remove-ImageGroup /ImageGroup:<image group name>.

This procedure deletes the image group folder and all of its contents from the image store. For install images, if an associated data folder exists (the folder that contains unattend files or language packs), it will be removed as well.

To add an image group to the image store

Using the MMC Using WDSUTIL
  1. Right-click the Install Images node, and then click Add Image Group.

  2. Enter the name for the image group.
  1. Click Start, right-click Command Prompt, and click Run as administrator.

  2. Run WDSUTIL /Add-ImageGroup /ImageGroup:<image group name>.

The preceding procedure creates a folder in the image store with the specified name.

To set the attributes on an image group

Use the following procedure to set the name and access controls for an image group.

Note

Changing the name renames the image group folder in the image store, and changing the security sets ACLs on the folder and its contents.

Using the MMC Using WDSUTIL
  1. Right-click image group, and then click Rename.

  2. Right-click image group, and then click Security.
  1. Click Start, right-click Command Prompt, and click Run as administrator.

  2. To change the name, run WDSUTIL /Set-ImageGroup /ImageGroup:<existing image group name> /Name:<new image group name>.

  3. To set the security, run WDSUTIL /Set-ImageGroup /ImageGroup:<image group name> /Security:<SDDL>, where SDDL is the security descriptor you want to use for the image group, in Security Descriptor Definition Language (SDDL) format.

To display information about all images in an image group

Using the MMC Using WDSUTIL
  1. Select an image group.

  2. View the images in the right pane.
  1. Click Start, right-click Command Prompt, and click Run as administrator.

  2. Run WDSUTIL /Get-ImageGroup /ImageGroup:<image group name>. To display the full image metadata on each image in the group, append /Detailed.