Deploying Microsoft ADK files

These steps are only required if you have installed PXE Everywhere Agent using the 1E Client installer instead of using the 1E Client Deployment Assistant (CDA) which is the recommended method of including the Microsoft ADK files in the deployment of PXE Everywhere Agent. A script similar to the one provided below was originally used for legacy versions of PXE Everywhere Agent and CDA which did not include the ADK files, and required the ADK files to be deployed as a post-installation task along with the 1E PXE Everywhere boot images.

Obtaining the Microsoft ADK files

In addition to the binaries supplied by 1E, PXE Everywhere Agent requires a number of files that are distributed and licensed with the Microsoft Windows Automated Deployment Kit (ADK). As these files are licensed by Microsoft, 1E are unable to include them in the installation media. However, you can use the Client Deployment Assistant to extract the required files from the ADK, create an installer transform and prepare an Application in Configuration Manager that will install the PXE Everywhere Agent with the appropriate settings and the additional Microsoft files.

The Windows Assessment and Deployment Kits (ADK) normally exist on the Configuration Manager CAS or Primary Site server, although they can be downloaded separately from the Microsoft website.

If you are not using CDA, then you must extract the files listed below from Windows ADK, and then deploy them to PXE Everywhere Agents.

  • boot.sdi

  • abortpxe.com

  • bootmgr.exe

  • pxeboot.com

  • pxeboot.n12

  • bootmgfw.efi

  • wgl4_boot.ttf

Script to extract the ADK files

The following example script can be used to extract the files from the Windows ADK. It must be run on a standard Configuration Manager primary site server that has the Windows ADK installed. It extracts the required ADK files and copies them to the specified location. If the script were saved as ExtractADK.cmd and you have created a folder called C:\ADKFiles to receive the extracted files, the command line syntax would be:

Copy
ExtractADK.cmd C:\ADKFiles 

The script assumes that ADK is installed in C:\Program Files (x86)\Windows Kits\%WINVER% for example Windows 10, WINVER=10. If you have ADK installed at a different location, then you will need to modify your script.

ExtractADK.cmd script:

Copy
 @ECHO OFF
IF %1.==. GOTO :INPUTERROR
SET TARGETPATH=%~dpn1
SET WINVER=10
 
call "C:\Program Files (x86)\Windows Kits\%WINVER%\Assessment and Deployment Kit\Deployment Tools\DandISetEnv.bat"
 
imagex /unmount "%tmp%\winpe"
rd "%tmp%\winpe" /s /q
md "%tmp%\winpe"
md "%TARGETPATH%\Boot"
md "%TARGETPATH%\Boot\x86"
md "%TARGETPATH%\Boot\x64"
md "%TARGETPATH%\Boot\Fonts"
REM Extract x86 files
imagex /mount "c:\Program Files (x86)\Windows Kits\%WINVER%\Assessment and Deployment Kit\Windows Preinstallation Environment\x86\en-us\winpe.wim" 1 "%tmp%\winpe"
 
xcopy "C:\Program Files (x86)\Windows Kits\%WINVER%\Assessment and Deployment Kit\Windows Preinstallation Environment\x86\Media\Boot\boot.sdi" "%TARGETPATH%\" /y
xcopy "C:\Program Files (x86)\Windows Kits\%WINVER%\Assessment and Deployment Kit\Windows Preinstallation Environment\x86\Media\Boot\Fonts\wgl4_boot.ttf" "%TARGETPATH%\Boot\Fonts\" /y
xcopy "%tmp%\winpe\Windows\Boot\PXE\abortpxe.com" "%TARGETPATH%\Boot\x86\" /y
xcopy "%tmp%\winpe\Windows\Boot\PXE\bootmgr.exe" "%TARGETPATH%\Boot\x86\" /y
xcopy "%tmp%\winpe\Windows\Boot\PXE\pxeboot.com" "%TARGETPATH%\Boot\x86\" /y
xcopy "%tmp%\winpe\Windows\Boot\PXE\pxeboot.n12" "%TARGETPATH%\Boot\x86\" /y
xcopy "%tmp%\winpe\Windows\Boot\EFI\bootmgfw.efi" "%TARGETPATH%\Boot\x86\" /y
 
imagex /unmount "%tmp%\winpe"
REM Extract x64 files
imagex /mount "c:\Program Files (x86)\Windows Kits\%WINVER%\Assessment and Deployment Kit\Windows Preinstallation Environment\amd64\en-us\winpe.wim" 1 "%tmp%\winpe"
 
xcopy "%tmp%\winpe\Windows\Boot\EFI\bootmgfw.efi" "%TARGETPATH%\Boot\x64\" /y
 
imagex /unmount "%tmp%\winpe"
GOTO DONE
 
:INPUTERROR
 
ECHO Please specify the path to where to create TFTPRoot files
ECHO.
ECHO Example: %0 C:\temp\pxebootfiles
ECHO.
GOTO :EOF
 
:DONE
CD /D %TARGETPATH%

Deploying the ADK files

Updated ADK files must be deployed to PXE Everywhere Agents, into their TFTPROOT directory, along with the 1E PXE Everywhere boot images, refer to Preparing and deploying 1E PXE Everywhere boot images. By default, TftpRoot is %ALLUSERSPROFILE%\1E\PXEEverywhere\TftpRoot and the 1E PXE Everywhere boot images should be found in an \Images folder relative to TFTPROOT.

In addition to the binaries supplied by 1E, PXE Everywhere Agent requires a number of files that are distributed and licensed with the Windows ADK. The required files are listed in the following table along with the location on the PXE Everywhere Agent that they need to be installed to.

File

Destination Location (relative to TFTPROOT)

boot.sdi

\boot.sdi

abortpxe.com

\boot\x86\abortpxe.com

bootmgr.exe

\boot\x86\bootmgr.exe

pxeboot.com

\boot\x86\pxeboot.com

pxeboot.n12

\boot\x86\pxeboot.n12

bootmgfw.efi

\boot\x86\bootmgfw.efi

\boot\x64\bootmgfw.efi

 

wgl4_boot.ttf (optional)

\boot\fonts\wgl4_boot.ttf