WinPE PreBoot Support (Version 1.3.8)


WinPE PreBoot Support is the next step within Empirum OS Installer. It now allows all customers to create their own – Powershell based – packages and using their own tools – pretty similar as creating and using software packages on Windows. Having this flexibility, it gives you more options to realize full featured OS provisioning (e.g. including BIOS settings or updates using vendor specific tools).
The base version of Empirum is v17.0 Update 2. The download extends and updates the existing functionality. Please see the change history below.


  • 2018-04-19: Update to 1.3.8
    • OS Package Editor 1.1 is added as importable software package and fixed the following issue
      • Special characters from decription field are encoded correctly within Install.ps1 when creating a new package
    • OS packages are physically removed when they are deleted in EMC
    • Get-EmpirumAgentSetting can be used to retrieve value for PowerShellTimeoutInSeconds setting
    • DeviceMapping file will be renewed if necessary
    • Non unique client entries (UUIDs or MACs) are handled now correctly
  • 2018-04-06: Update to 1.3.6
    • Added new package "BiosUpdateTemplate version 1.0" (Package serves as a template and has one implementation for a Dell device)
    • Increased default timeout for PowerShell script execution to 3600 seconds (for slow computers)
    • Added app setting PowerShellTimeoutInSeconds to PE Agent dll config for custom timeout configuration.
    • Support for UUID when sending PXE messages
    • UUID remote log folder is created if a remote log folder is not present and a MAC8 folder can not be created
    • Package Updates
      • SimpleOsDeployment to version 3.3
      • WindowsInstallation to version 3.3
      • HardwareInfo to version 2.2
      • DriverIntegration to version 2.3 (now supports folders, too)
    • Added new Matrix42 PreOS Package Editor software package (can be found at EmpirumConfiguratorPackagesMatrix42PreOS Package Editor)
  • 2018-03-01: Update to 1.3.3
    • PreOS packages are stored now under Configurator$PackageStorePreOsPackages
    • Bugfixes
      • Excecution of PreOS packages and copying log to server fail when client respectively device mapping xml doesn't contain SMBIOS UUID but only mac address
      • If only one Dhcp option is set, the value will not be read out
      • As UAF has changed path for its log PeAgent couldn't copy it to server
  • 2018-02-14: Update to 1.3.0
    • Added DHCP options support for multi depot support
    • Optimization at WinPE boot image creation. Reusing boot.wim files with same content.
    • Added new PreOS package DebugPackage 1.0
    • Updated HardwareInfo package to 2.1 - Output of manufacturer and model information
    • PXE Off messages are sent also with the MAC address from Device Mapping XML now:
      • PXE Off is sent with the same MAC address as used while PXE boot / client activation
      • Works independent from MAC Pass Through or USB-to-ethernet adapters
      • Requires SMBios GUIDs to be present, which are used to map to related MAC addresses
    • Packages SimpleOsDeployment 3.2 and WindowsInstallation 3.2 read logon information from Depot settings
    • Packages Diskpartitioning 3.1 and SimpleOsDeployment 3.2 send a PXE log message to reset statuses of all previously installed software packages.
    • Bugfixes:
      • PRB158127: Fixed PEAgent behaviour if the DDC entries have too many columns (e.g. software packages with revoke values)
      • PRB158131: Fixed BTQH Queue behaviour if an exception is thrown at executing powershell script (e.g. because of missing disk space)
      • Cortana is silent during Windows installation (SimpleOSDeployment 3.2 and windowsInstallation 3.2).
  • 2018-01-04: Update to 1.2.3
    • Added support for Domain Join with an specific OU
  • 2017-12-14: Part of Empirum 17.0 Update 2
    • PreBoot packages for WinPE based OS installations can now be imported directly from the console.
    • The target platform can be selected in the WinPE boot configuration. x64 or x86 as well as UEFI and BIOS. Depending on the selection, separate WinPE Boot WIM files are created for BIOS and UEFI.
    • New PreBoot installation and configuration packages.
      • Multi-platform support
      • Advanced partitioning capabilities
      • Improved driver support
    • Significantly improved download time for WinPE network boot
  • 2017-10-20: Update to 1.1.2
    • Updated WindowsInstallation package to version 1.1 - improved Advanced Agent installation
    • Updated DriverIntegration package to version 2.0 - driver archive input via variables.
    • Matrix42 OS Deployment with WinPE - HowTo documentation DE/EN.
  • 2017-10-13: Update to 1.1.1
    • New PreOS package WindowsInstallation 1.0
    • Renamed packages DriverIntegration 1.0 and DiskPartitioning 1.0
    • DriverIntegration package relies on DiskPartitioning package for the partitioning functionality
    • Bug fixes:
      - Abort creation of a WinPE boot image if user temp directory path is too long
      - Fixed reported status for successfully installed packages
      - Import variables of type Dropdown, Checkbox, Combobox and Extended Dropdown
      - Fixed unnecessary rewrite of the computer ini files upon package import
  • 2017-10-05: Update for v17.0 Update 1 (1.0.14)
    • Packages Update
    • OS Agent now supports installation sequence
    • Windows PE show an improved UI

Known Issues and limitations

  • Creation of a PXE Boot image requires latest Windows Admistration and Deployment Kit (WADK) installed on the master server (where the backend task queue service runs on)
  • OS Agent supports SMB protocol only based on the server settings of the agent template


Updates are supported from the following version:
  • Matrix42 Empirum v17.0 Update 2 incl. current Hotfix Installer
  • Windows Server 2012 R2 or Windows Server 2016 on the Empirum Master Server.


The documention for support Windows PE within Empirum is currently available in English and German and can be downloaded here: