DISM Windows Edition-Servicing Command-Line Options

  • Article

You can use the Windows edition-servicing commands to change one edition of Windows 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 don't 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.

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:

```cmd
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.

/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

Use /Set-Edition 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 shouldn't 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.

Syntax:

/Set-Edition:<target_edition_ID> [{/GetEula:<path | /AcceptEula /ProductKey:<product_key>}]
  • Use /GetEula on an online image to copy the end-user license agreement to a specified path.
  • /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

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 /Set-Edition.

Example:

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

Limitations

  • If you don't 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.

What is DISM?

DISM Image Management Command-Line Options

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

Change the Windows Image to a Higher Edition Using DISM