DISM Windows Edition-Servicing Command-Line Options

  • Article

Applies To: Windows 8, Windows 8.1, Windows Server 2012, Windows Server 2012 R2

You can use the Windows® edition-servicing commands to change one edition of Windows® 8 to a higher edition in the same edition family. The edition packages for each potential target edition are staged in a Windows image. This is referred to as an edition-family image. Because the target editions are staged, you can service a single image, and the updates will be applied appropriately to each edition in the image. This can help reduce the number of images that you have to manage, but it might increase the factory time or end-user time that must be spent in the specialize configuration pass.

Offline changes do not require a product key. If you change to a higher edition using offline servicing, you can add the product key using one of the following methods:

  • Enter the product key during the out-of-box experience (OOBE).

  • Use an unattended answer file to enter the product key during the specialize configuration pass.

  • Use Deployment Image Servicing and Management (DISM) and the Windows edition-servicing command-line option /Set-ProductKey after you set the edition offline.

In this topic:

Command-line Syntax

Limitations

Command-line Syntax

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

DISM.exe {/Image:<path_to_image_directory> | /Online} [dism_global_options] {servicing_option} [<servicing_argument>]

You can use the following edition-servicing options on an offline image to list editions or to change a Windows image to a higher edition:

DISM.exe /Image:<path_to_image_directory> {/Get-CurrentEdition | /Get-TargetEditions | /Optimize-Image /WIMBoot | /Set-Edition | /Set-ProductKey:<product_key>}

The following edition-servicing options are available for a running Windows operating system:

DISM.exe /Online {/Get-CurrentEdition | /Get-TargetEditions | /Set-ProductKey:<product_key> | /Set-Edition:<target_edition> {/GetEula:< path> | /AcceptEula/ProductKey:<product_key>}}

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

Option Description

/Get-Help

/?

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

Examples:

Dism /Image:C:\test\offline /Get-CurrentEdition /?

Dism /Online /Get-CurrentEdition /?

/Get-CurrentEdition

Displays the edition of the specified image.

Examples:

Dism /Image:C:\test\offline /Get-CurrentEdition

Dism /Online /Get-CurrentEdition

/Get-TargetEditions

Displays a list of Windows editions that an image can be changed to.

Examples:

Dism /Image:C:\test\offline /Get-TargetEditions

Dism /Online /Get-TargetEditions

/Set-Edition:<target_edition_ID> [{/GetEula:<path | /AcceptEula/ProductKey:<product_key>}]

Use the /Set-Edition option with no arguments to change an offline Windows image to a higher edition.

To change an online Windows Server operation system to a higher edition, you must use the /Set-Edition option with the /AcceptEula and /ProductKey arguments.

Important
You should not use the /Set-Edition option on an image that has already been changed to a higher edition. It is recommended that you use this option on the lowest edition available in the edition family.

Use /GetEula on an online image to copy the end-user license agreement to a specified path.

The /AcceptEula argument accepts the end-user license agreement and is required in order to change the Windows edition on an online image.

Example:

Dism /Image:C:\test\offline /Set-Edition:<edition name>

On a running Windows Server operating system only:

Dism /online /Set-Edition:<edition name> /GetEula:c:\eulapath
Dism /online /Set-Edition:<edition name>/AcceptEula /ProductKey:12345-67890-12345-67890-12345

Where <edition name> is the higher edition that you want to change to.

/Set-ProductKey:<productKey>

The /Set-ProductKey option can only be used to enter the product key for the current edition in an offline Windows image after you change an offline Windows image to a higher edition using the /Set-Edition option.

Example:

Dism /Image:C:\test\offline /Set-ProductKey:12345-67890-12345-67890-12345

Limitations

  • If you do not enter the product key when you set the edition of your offline image, you must either enter the product key during OOBE, or use an unattended answer file to enter the product key during the specialize configuration pass.

  • You cannot use edition-servicing commands on a Windows Preinstallation Environment (Windows PE) image.

  • To maintain edition-specific customizations, you should apply edition-specific answer files after the edition upgrade.

  • If you want to run the /Set-Edition option against a 64-bit image with more than 30 language packs, you must run it from a 64-bit computer. Otherwise, you might receive an out-of-memory error. This limitation only exists if you are manipulating a 64-bit image from a 32-bit computer. This limitation does not exist when you run this option on a computer that matches the architecture of the image.

  • You cannot set a Windows image to a lower edition. The lowest edition will not appear when you run the /Get-TargetEditions option.

  • You should not use the /Set-Edition option on an image that has already been changed to a higher edition.

See Also

Tasks

Change the Windows Image to a Higher Edition Using DISM

Reference

DISM Image Management Command-Line Options

Concepts

DISM Overview (Deployment Image Servicing and Management)

Other Resources

Deployment Image Servicing and Management (DISM) Command-Line Options