How to use the EpeWinUpgrade tool for automated creation of WinPE 3.x (and later) with Drive Encryption

Technical Articles ID: KB79853
Last Modified: 2024-01-06 08:55:50 Etc/GMT

Environment

Drive Encryption (DE) 7.1

For details of DE 7.1.x supported environments, see KB79422 - Supported platforms for Drive Encryption 7.x.

Summary

The EpeWinUpgradeTool utility is a Windows Command-Line tool used to inject DE files, drivers, and registry entries into a WIM file. This process creates a customized WinPE image that contains DETech recovery software. Using this utility requires the user to have a strong knowledge of Microsoft Windows Assessment and Deployment Kit Version 4.0 or later. For more information, see this Microsoft article.

This article, which is linked from the DETech 7.1 Guide (PD24871), explains how to use the attached tool to simplify the creation of WinPE 3.x recovery media by automating the process.

The attached tools (DETech64bit.zip and DETech32bit.zip) enable file injection and the addition of registry items to the WinPE image.

The attached tools can be used for two purposes:

To use the EpeWinUpgrade tool for creating WinPE 3.x (and higher) CD media.
To perform an Operating System (OS) Refresh using standard Microsoft Tools. For details of how to use this tool for the OS Refresh process, see KB79908 - INTERNAL - How to upgrade a Windows operating system with Drive Encryption installed.

Command-line switches

Command <parameter>	Purpose
-SetFileLocks <Lock\|Unlock>	Locks/Unlocks the system files
-SaveMbr <filename>	Saves the current MBR to file
-SetMbr <filename>	Restores MBR from file
-Inject <drivers dir> <image>	Injects software encryption drivers into a WIM image
-InjectOpal <drivers dir> <image>	Injects Opal encryption drivers into a WIM image
-CopyFiles <filelist> <src dir> <dst dir> <image>	Copies files into a WIM image
-MountWim <image> <mount path>	Mounts the WIM in the specified dir
-UnmountWim <mount_path> [save]	Unmounts the WIM and updates WIM if "save"
-ForceMbr <filename> [frequency=<Hz>]	Restores MBR from file continuously

IMPORTANT: These tools require command-line switches to launch them. The switches you use depends on the purpose you intend to use the tool for. If you attempt to run the executable without any switches, it causes the application to display the following message followed by a list of the available switches:

Usage:
Command <parameter>

Package content details of key files

Package	Extracted location	File	Comments
DETech64bit.zip	DETech64bit\	EpeWinUpgradeTool64.exe	64-bit main executable to run with specific commands and parameters as detailed below to inject files into a 64-bit WinPE WIM image.
	DETech64bit\FileLists\	DETech64Files.txt	64-bit file list required for EpeWinUpgradeTool64.exe to inject necessary software encryption files into a WinPE WIM image.
		DETechOpal64Files.txt	64-bit file list required for EpeWinUpgradeTool64.exe to inject necessary hardware encryption files into a WinPE WIM image.
	DETech64bit\Files\	Various files	64-bit files required to be injected into the WinPE WIM image.

DETech32bit.zip	DETech32bit\	EpeWinUpgradeTool.exe	32-bit main executable to run with specific commands and parameter as detailed below to inject files into a 32-bit WinPE WIM image.
	DETech32bit\FileLists\	DETech32Files.txt	32-bit file list required for EpeWinUpgradeTool.exe to inject necessary software encryption files into a WinPE WIM image.
		DETechOpal32Files.txt	32-bit file list required for EpeWinUpgradeTool.exe to inject necessary hardware encryption files into a WinPE WIM image.
	DETech32bit\Files	Various Files	32-bit files required to be injected into the WinPE WIM image.

Solution

How to use the tools for automated creation of WinPE 3.x (and later):

Download the required package for the WinPE version that you want to build (32-bit or 64-bit).
Extract the WinZip archive file to a local folder. Example: C:\EpeWinUpgradeTool.
Open a command prompt to the extracted folder.
To inject the DETech drivers and registry entries, use the following commands from the prompt:

For non-Opal systems:
Run the command EpeWinUpgradeTool –Inject <Files dir> <image>

For Opal systems
Run the command EpeWinUpgradeTool –InjectOpal <Files dir> <image>

Here,
<Files dir> is the file folder within the EpeWinugradeTool folder.
<image> is the full path to the WIM image to modify.
To copy the DETech files, use the following at the command prompt:

Command-line syntax: EpeWinUpgradeTool –Copyfiles <file list> <src dir> <dst dir> <image>

Here,
<file list> is a Unicode (UTF16) text file containing the formatted src_filepath=dst_filepath.
<src dir> is the path to copy the files from example C:\EpeWinUpgradeTool\FileList.
<dst dir> is the path to copy the files to the WIM image.
<image> is the full path to the WIM image to modify.

Examples:

For non-Opal systems:
EpeWinUpgradeTool –Copyfiles C:\EpeWinUpgradeTool\FileLists\EETech64Files.txt C:\EpeWinUpgradeTool\Files C:\WIM.wim\Files C:\WIM.wim

For Opal systems:
EpeWinUpgradeTool –Copyfiles C:\EpeWinUpgradeTool\FileLists\EETechOpal64Files.txt C:\EpeWinUpgradeTool\Files C:\WIM.wim\Files C:\WIM.wim
After the WinPE WIM image has been created, convert it into a bootable ISO image.

Attachment 1

DETech32bit.zip
4.5MB • < 1 minute @ broadband

Attachment 2

DETech64bit.zip
5.3MB • < 1 minute @ broadband

Affected Products

Drive Encryption 7.2 (EOL)

Languages:

This article is available in the following languages:

Knowledge Center

How to use the EpeWinUpgrade tool for automated creation of WinPE 3.x (and later) with Drive Encryption

Environment

Summary

Solution

Attachment 1

Attachment 2

Affected Products

Languages:

Title

Title

Knowledge Center

How to use the EpeWinUpgrade tool for automated creation of WinPE 3.x (and later) with Drive Encryption

Environment

Summary

Solution

Attachment 1

Attachment 2

Affected Products

Languages:

Choose your region

Title

Title