DISM

The Deployment Image Servicing and Management (DISM) platform is used to mount and service Windows images before deployment. A subset of DISM commands can be used on online Windows images. You can use DISM tools to mount, and get information about, Windows image (.wim) files or virtual hard disks (.vhd or .vhdx). You can also use it to install, uninstall, configure, and update Windows features, packages, and drivers in a Windows image or to change the edition of a Windows image.

This topic introduces the DISM cmdlets available in the DISM PowerShell module. This module is available in Windows 8.1 and Windows Server 2012 R2. On other supported operating systems, you can install the DISM module from the Windows Assessment and Deployment Kit (Windows ADK) . For more information about how to use the DISM PowerShell module installed with the ADK, see How to Use DISM in Windows PowerShell .

For Windows 8.1 and Windows Server 2012 R2, Windows PowerShell 4.0 is included in the installation. For other supported versions of Windows and Windows Server, (including Windows 8, Windows 7 SP1, Windows Server 2012, and Windows Server 2008 R2 SP1), you must install Windows Management Framework 4.0. You can download and install Windows Management Framework 4.0 from the Microsoft Download Center.

The DISM platform also includes a command-line tool, DISM.exe, and the DISM API . The command-line tool is available in the Windows Assessment and Deployment Kit (Windows ADK) and includes additional functionality that supports servicing commands for international settings.

You can check for errors when running DISM cmdlets by checking if the $?. If set to True the last operation succeeded. If False the last operation failed. The $LASTEXITCODE contains the exit code of the last Win32 executable run. For example, to check that the Get-WindowsImage cmdlet fails to get information about the Windows image contained in the file, E:\images\c.wim, type the following:

try
{

    Get-WindowsImage -ImagePath E:\images\c.wim
}
catch
{
    $message = "TRAPPED: {0}: '{1}'" -f ($_.Exception.GetType().FullName), ($_.Exception.Message)
    Write-host $message
}

For more information about error handling, see the about_Try_Catch_Finally .

dism

Add-Appx Provisioned Package

Adds an app package (.appx) that will install for each new user to a Windows image.

Add-Windows Capability

Installs a Windows capability package on the specified operating system image.

Add-Windows Driver

Adds a driver to an offline Windows image.

Add-Windows Image

Adds an additional image to an existing image (.wim) file.

Add-Windows Package

Adds a single .cab or .msu file to a Windows image.

Clear-Windows Corrupt Mount Point

Deletes all of the resources associated with a mounted image that has been corrupted.

Disable-Windows Optional Feature

Disables a feature in a Windows image.

Dismount-Windows Image

Dismounts a Windows image from the directory it is mapped to.

Enable-Windows Optional Feature

Enables a feature in a Windows image.

Expand-Windows Custom Data Image

Expands a custom data image.

Expand-Windows Image

Applies an image to a specified location.

Export-Windows Driver

Exports all third-party drivers from a Windows image to a destination folder.

Export-Windows Image

Exports a copy of the specified image to another image file.

Get-Appx Provisioned Package

Gets information about app packages (.appx) in an image that will be installed for each new user.

Get-WIMBoot Entry

Displays the Windows image file boot (WIMBoot) configuration entries for a specified disk volume.

Get-Windows Capability

Gets Windows capabilities for an image or a running operating system.

Get-Windows Driver

Displays information about drivers in a Windows image.

Get-Windows Edition

Gets edition information about a Windows image.

Get-Windows Image

Gets information about a Windows image in a WIM or VHD file.

Get-Windows Image Content

Displays a list of the files and folders in a specified image.

Get-Windows Optional Feature

Gets information about optional features in a Windows image.

Get-Windows Package

Gets information about packages in a Windows image.

Mount-Windows Image

Mounts a Windows image in a WIM or VHD file to a directory on the local computer.

New-Windows Custom Image

Captures an image of customized or serviced Windows components on a Windows Image File Boot (WIMBoot) configured device.

New-Windows Image

Captures an image of a drive to a new WIM file.

Optimize-Windows Image

Configures a Windows image with specified optimizations.

Remove-Appx Provisioned Package

Removes an app package (.appx) from a Windows image.

Remove-Windows Capability

Uninstalls a Windows capability package from an image.

Remove-Windows Driver

Removes a driver from an offline Windows image.

Remove-Windows Image

Deletes the specified volume image from a WIM file that has multiple volume images.

Remove-Windows Package

Removes a package from a Windows image.

Repair-Windows Image

Repairs a Windows image in a WIM or VHD file.

Save-Windows Image

Applies changes made to a mounted image to its WIM or VHD file.

Set-App XProvisioned Data File

Adds custom data into the specified app (.appx) package that has been provisioned in a Windows image.

Set-Windows Edition

Changes a Windows image to a higher edition.

Set-Windows Product Key

Sets the product key for the Windows image.

Split-Windows Image

Splits an existing .wim file into multiple read-only split .wim files.

Update-WIMBoot Entry

Updates the Windows image file boot (WIMBoot) configuration entry, associated with either the specified data source ID, the renamed image file path or the moved image file path.

Use-Windows Unattend

Applies an unattended answer file to a Windows image.