Application servicing command-line options can be used on a offline image to check the applicability of Windows® Installer application patches (.msp files) and to query your offline image for information about installed Windows Installer applications and application patches (.msp files).

The base syntax for servicing a Windows image using DISM is:

DISM.exe /Image:<path_to image_directory> [dism_options] {servicing_command} [<servicing_argument>]

The following servicing options are available to list Windows Installer applications and .msp application patches, and to check the applicability of an application patch for a offline Windows image:

DISM.exe /Image:<path_to_directory> [/Check-AppPatch | /Get-AppPatchInfo: | /Get-AppPatches | /Get-AppInfo | /Get-Apps]

The following table provides a description of how each application servicing option can be used. These options are not case sensitive.

Option Description

/Get-Help

/?

When used immediately after a package servicing command-line option, information about the option and the arguments is displayed. Additional topics might become available when an image is specified.

Example:

Dism /image:C:\test\offline /Check-AppPatch /? 

/Check-AppPatch /PatchLocation:<path_to_patch.msp>

Displays information only if the MSP patches are applicable to the offline image. The path to the MSP patch file must be specified. Multiple patch files can be specified.

Example:

Dism /image:C:\test\offline /Check-AppPatch /PatchLocation:C:\test\MSIPatches\MsiTestPatch1.msp
 /PatchLocation:C:\test\MSIPatches\MsiTestPatch2.msp

/Get-AppPatchInfo: [/PatchCode:<patch_code_GUID>] [/ProductCode:<product_code_GUID>]

Displays detailed information about installed MSP patches filtered by <patch_code_GUID> and <product_code_GUID>.

If the /PatchCode option is specified, detailed information is displayed for all Windows Installer applications that the patch is applied to.

If the /ProductCode option is specified, information about all MSP patches in the specified application is displayed.

If the /PatchCode and /ProductCode options are specified, information is displayed only if that specific patch is applied to the specified Windows Installer application.

Use the /Get-AppPatches option to find the patch code GUID and the product code GUID specific to the patch. Use the /Get-Apps option to list all product code GUIDs for an installed Windows Installer applications.

If /PatchCode and /ProductCode are not specified, all installed Windows Installer packages and MSP patches are displayed.

Example:

Dism /image:C:\test\offline /Get-AppPatchInfo
Dism /image:C:\test\offline /Get-AppPatchInfo: /PatchCode:{B0B9997C-GUID-GUID-GUID-74D866BBDFFF}
Dism /image:C:\test\offline /Get-AppPatchInfo: /ProductCode:{B0F9497C-GUID-GUID-GUID-74D866BBDF59}
Dism /image:C:\test\offline /Get-AppPatchInfo: /PatchCode:{B0B9997C-GUID-GUID-GUID-74D866BBDFFF} /ProductCode:{B0F9497C-GUID-GUID-GUID-74D866BBDF59}

/Get-AppPatches: [/ProductCode:<product_code_GUID>]

Displays basic information about all applied MSP patches for all applications installed on the offline image. If a product code GUID is specified, information is displayed about all patches in the specified Windows Installer application.

Examples:

Dism /image:C:\test\offline /Get-AppPatches
Dism /image:C:\test\offline /Get-AppPatches /ProductCode:{B0F9497C-GUID-GUID-GUID-74D866BBDF59}

/Get-AppInfo: [/ProductCode:<product_code_GUID>]

Displays detailed information about a specific installed Windows Installer application.

Use the /Get-Apps option to find the GUID for an installed Windows Installer application. If a product code GUID is not specified, information is displayed for all Windows Installer applications installed in the offline image.

Examples:

Dism /image:C:\test\offline /Get-AppInfo
Dism /image:C:\test\offline /Get-AppInfo /ProductCode:{B0F9497C-GUID-GUID-GUID-74D866BBDF59}

/Get-Apps

Displays basic information about all Windows Installer applications in the offline image.

Example:

Dism /image:C:\test\offline /Get-Apps

Limitations

/Get-AppPatches and /Get-AppPatchInfo apply only to installed patches (.msp files).

When you check the applicability of an MSP patch, only the Windows Installer applications for which the patch is applicable will be displayed. One patch can be applicable to many installed applications and many patches can be applicable to one application.

See Also