Overview

• Automated windows command script to process Microsoft Windows 10 Unified Update Platform files, allowing to build/convert them into a usable state (ISO / WIM).


• You can get UUP files by performing upgrade from Windows 10 build to later build (starting 15063).


• You can also obtain UUP canonical source using one of these projects:
  UUP dump website
  UUP dump downloader
  UUPDL
  UUP Generation Project

---

How To Use

• Administrator privileges are required to run the script.


• Optional: temporary disable AV or protection program so it doesn't interfere with the process.


• Make sure the files are not read-only or blocked.


• Extract this pack to a folder with simple spaceless path to avoid troubles (example: C:\UUP).


• Place the files in "UUPs" folder to be detected automatically, or drag and drop uup files directory on convert-UUP.cmd. Alternatively, you will be prompted to enter other UUP folder path.


• If multiple Editions detected, you will be prompted first to select one of them, or create AIO.


• To exit of the prompt or options menu just press "Enter".

---

Output Choice

• 1 - Create ISO with install.wim
  4 - Create ISO with install.esd
  
  convert UUP files to a regular ISO distribution that contains install.wim or install.esd file.


• 2 - Create install.wim
  5 - Create install.esd
  
  create install.wim/install.esd file only, which can be used with other ISO with the same version or for manual apply using dism, imagex, wimlib.


• 3 - UUP Edition info
  
  Display info about detected editions (architecture, language, build version, build branch, editions name).


• 6 - Configuration Options
  
  Change the state of configuration options.

---

Configuration Options

Control conversion behavior, output and automation.

You have three ways to change the state of these options, where 0 means the option is OFF (no), and 1 means the option is ON (yes):
- edit ConvertConfig.ini under [convert-UUP] section
- delete ConvertConfig.ini and edit convert-UUP.cmd script directly
- use menu choice 6 (AutoStart option is excluded from this)

• AutoStart
  
  Start the conversion process directly without prompts.
  
  This require placing UUP files in *UUPs* folder, or starting convert-UUP.cmd from command prompt with path to UUP source folder, or drag and drop UUP source folder on convert-UUP.cmd.
  
  Set this option to 1 to create ISO with install.wim
  Set this option to 2 to create ISO with install.esd


• AddUpdates
  
  Integrate detected updates after creating wim files.
  
  Use ResetBase option to control OS image cleanup.
  Use NetFx3 option to enable .NET 3.5 feature.
  
  These options only work with install.wim choices, and require Windows 10 Host OS or ADK. See Add Updates Option for more details.


• StartVirtual
  
  Start create_virtual_editions.cmd directly after conversion is completed.
  
  See Virtual Editions for more details.


• wim2esd
  
  Convert install.wim to install.esd at the end.
  
  This option is intended to be used with option AddUpdates.
  
  This option will be auto enabled if you selected install.esd choice and AddUpdates is ON.
  
  Warning: creating install.esd will consume high amount of CPU/RAM, and might take considerable time to complete.


• SkipISO
  
  If you are not interested to create ISO file currently, or want to create Multi-Architecture ISO (x86/x64) later with multi_arch_iso.cmd, or intend to manually use create_virtual_editions.cmd
  


• SkipWinRE
  
  Do not add winre.wim to install.wim/install.esd, if you are not interested to have recovery environment or want to reduce ISO size/conversion period.. etc.
  
  note: adding winre.wim to install.esd will consume high amount of CPU/RAM.


• ForceDism
  
  Use the official method with dism.exe for creating boot.wim, which require Windows 10 Host OS or ADK.
  


• RefESD
  
  Keep converted reference ESD files for future operations instead converting them each time.
  
  if UUP source is Express, Reference ESDs and Edition ESDs will be copied to new folder "CanonicalUUP", practically, this convert/backup Express UUP source to Canonical.
  if UUP source is Canonical, Reference ESDs will be copied to the same UUP source folder, and original CAB files will be moved to subdirectory "Original".

---

Add Updates Option

Info

• Starting Windows 10 version 1709, Servicing Stack Update and Latest Cumulative Update are handled and distributed with UUP source.
  In addition to some small dynamic updates used in upgrades.


• According to that, UUP Dump will offer multiple builds for the same Windows 10 version.
  Each one will represent refreshed Feature Update or new Cumulative Update.


• However, those updates are only used and applied by Windows Update,
  they not actual part of the UUP source itself and will not be included in the converted ISO/WIM by default.


• The recommended choice to get those updates incorporated, is to convert UUP to ISO normally,
  afterwards you can use W10UI.cmd script or similar projects to integrate all available updates.


• Nevertheless, AddUpdates option provide built-in ability to directly integrate these updates, resulting a refreshed ISO/WIM.


• Note: This only works with install.wim (option 1 or 2 in the choices menu), because install.esd file is not servicable.

How To

• Make sure UUP source contain updates (Windows10.0-KB*.cab files)


• Optional: set convert-UUP option AddUpdates to 1


• You must have Windows 10 Host OS, or install Windows 10 ADK


• If updates are detected, you will have extra option 9 - Add Updates. Enter 9 to change the status (Yes or No) before choosing option 1 or 2

Note

by default, superseded components due updates in OS image will be delta-compressed

to reset OS image base and remove superseded components, set convert-UUP option ResetBase to 1 prior conversion

warning: resetbase break "Reset This PC" feature

---

Virtual Editions

Info

• Starting Windows 10 build 17063, regular editions have been unified into two base editions: Home & Pro (with their variants Home N & Pro N)
  
  Home China edition is still separate


• According to that, UUP will deliver installation files for the above editions only


• The following editions are now exist as "virtual upgrade editions" with base editions:
  
  Home -> Home Single Language
Pro N -> Enterprise N, Education N, Pro Education N, Pro N for Workstations
Pro -> Enterprise, Education, Pro Education, Pro for Workstations, Enterprise for Virtual Desktops, IoT Enterprise (build 18277 and later)


• Therefore, the extra script is to help create these additional editions from UUP source.

How To

• Supported source distribution:
  - Folder placed next to the script. (auto detected)
  - DVD Drive, i.e. mounted iso/real dvd drive/usb drive. (auto detected)
  - Direct ISO file. (you will prompted to specify one)


• Optional: if you do not intend to keep base converted ISO, set convert-UUP option SkipISO to 1.


• Use convert-UUP.cmd to create the source distribution.


• Run create_virtual_editions.cmd and choose the desired option from choices.

Options

• 1 - Create all editions
  create all possible target virtual editions.


• 2 - Create one edition
  create one of the target virtual editions.


• 3 - Create randomly selected editions
  create some of the target virtual editions.

Config Options

Control process behavior, output and automation.

You have two ways to change the state of these options, where 0 means the option is OFF (no), and 1 means the option is ON (yes):
- edit ConvertConfig.ini under [create_virtual_editions] section
- delete ConvertConfig.ini and edit create_virtual_editions.cmd script directly

• AutoStart
  
  Start the creation process directly without prompts.
  This require the source distribution to be ready (folder or drive).
  Only the editions specified in AutoEditions will be created, if no edition specified (empty), it will create all possible target editions.


• AutoEditions
  
  Specify editions to auto create with AutoStart option, separate the editions with a comma ,
  
  Leave this option empty to create all possible target editions.
  
  Allowed values: Enterprise, Education, ProfessionalEducation, ProfessionalWorkstation, EnterpriseN, EducationN, ProfessionalEducationN, ProfessionalWorkstationN, CoreSingleLanguage, ServerRdsh, IoTEnterprise
  
  Examples:
  vAutoEditions=Enterprise,ProfessionalWorkstation,Education
  vAutoEditions=


• DeleteSource
  
  Do not keep the source editions (example: create Enterprise and delete Pro).


• Preserve
  
  Preserve and keep source distribution folder intact, the operation will be done on copied folder instead.
  If source distribution is ISO file, this option has no affect.


• wim2esd
  
  Convert install.wim to install.esd at the end.
  
  Warning: creating install.esd will consume high amount of CPU/RAM, and might take considerable time to complete.


• SkipISO
  
  Do not create final ISO file at the end.

Note:

If create_virtual_editions.cmd is started from convert-UUP.cmd, options AutoStart & wim2esd will be inherited from convert-UUP section, regardless their current state under create_virtual_editions section

meaning, the script will auto-create virtual editions if convert-UUP's AutoStart=1
and install.wim will be converted to install.esd if convert-UUP's wim2esd=1, otherwise skip conversion if convert-UUP's wim2esd=0

---

Multi-Architecture ISO (x86/x64)

How To

• Optional: if you do not intend to keep single architecture ISOs, edit convert-UUP.cmd and set SkipISO=1


• Use convert-UUP.cmd to create two ISO distributions, one for x64 and another for x86, you may select the desired editions to include in each one


• Run multi_arch_iso.cmd and choose the desired option from menu

Options

• 1 - Create ISO with 1 combined install.wim/install.esd
  create a custom ISO structure.
  with 1 install.wim/install.esd for all x64/x86 images, and slighlty modified bootx64.wim/bootx86.wim to allow coexistence.


• 2 - Create ISO with 2 separate install.wim/install.esd (Win 10)
  create the same ISO structure as Media Creation Tool.
  with 2 separate x64/x86 folders and install.wim/install.esd for each architecture.

Notes

• To preserve source single-architecture distributions folders, edit multi_arch_iso.cmd and set Preserve=1


• If the installation file is install.esd, be aware that option 1 will require high amount of CPU/RAM to unify install.esd files


• multi_arch_iso.cmd can be used also to create multi-architecture ISO from any similar Windows x64/x86 ISO distributions, starting Windows 7 SP1
  however, option 2 require Windows 10 setup files.
  

---

Remark

• If the upgrade is done via Express UUP (multiple expanded folders in the download directory), you need to perform the UUP > ISO operation before starting the upgrade process (before first restart).
  to do so, when WU prompt you to restart, start convert-UUP.cmd and paste the path to download directory, example:
  • C:\Windows\SoftwareDistribution\Download\07172dda91861218ecc095600216d792
  
  Alternatively, if you are testing in VM machine or have multi boot systems, you can choose to Shut down/Restart the system without upgrading.
  on Desktop, press Alt+F4 and choose an option without Update

---

Credits

• mkuba50 - UUP dump
• Eric Biggers - wimlib
• Igor Pavlov - 7-zip
• erwan.l - offlinereg
• cdob - create aio efisys.bin
• rgadguard - initial script and co-enhancing
• Special thanks to: @Enthousiast, @s1ave77, @Ratiborus58, @NecrosoftCore, @DiamondMonday, @WzorNET
• cdimage, imagex and bcdedit are intellectual property of Microsoft Corporation.

Author: abbodi1406