Unlock BitLocker
Run this step in WinPE when you need to access the file system to make changes and cannot suspend BitLocker from the full OS.
This step is available only in DeployR Enterprise. It is hidden in DeployR Community, along with the other step definitions tagged Enterprise.
Once the required permissions are configured, this step retrieves the BitLocker recovery key for the device from Active Directory or Entra ID and unlocks the drive, allowing you to modify it in WinPE.
Devices with Keys in Entra
For devices in Entra ID, the BitlockerKey.Read.All permission is required. You can add the permission to your existing app registration, or follow the Microsoft Graph API access instructions to create an app registration in your Azure tenant and include the BitlockerKey.Read.All permission.
Devices with Keys in Active Directory
On the DeployR server, which is joined to the domain that keys will be recovered from, navigate to: C:\Program Files\2Pint Software\DeployR\WebServer\Scripts, where the script "RecoveryPasswordAccess.ps1" is located.
From an elevated PowerShell 7 console, run that script. The script is shown below for reference.


Task Sequence Editor
There are no options to configure on the step itself; just add it to the task sequence. An example task sequence might look like this: boot into DeployR WinPE from USB or PXE, unlock the BitLocker-encrypted drive, then make modifications to resolve an issue.

Task Sequence Running
When the task sequence runs in WinPE, the drive is unreadable before this step, and DiskPart shows "C" as unknown. After the Unlock BitLocker step, the drive is readable, and DiskPart shows the volume as NTFS because the recovery password was retrieved from Active Directory.
Pulling Recovery Key from Active Directory

Pulling Recovery Key from Entra

Last updated

