Troubleshoot disk unlocking issues in Azure Data Box Disk

This article applies to Microsoft Azure Data Box Disk and describes the workflows used to troubleshoot any issues when using the unlock tool.

Data Box Disk Unlock tool errors

Error message/Tool behavior Recommendations
The current .NET Framework isn't supported. The supported versions are 4.5 and later.

Tool exits with a message.
.NET 4.5 isn't installed. Install .NET 4.5 or later on the host computer that runs the Data Box Disk unlock tool.
Couldn't unlock or verify any volumes. Contact Microsoft Support.

The tool fails to unlock or verify any locked drive.
The tool couldn't unlock any of the locked drives with the supplied passkey. Contact Microsoft Support for next steps.
Following volumes are unlocked and verified.
Volume drive letters: E:
Couldn't unlock any volumes with the following passkeys: werwerqomnf, qwerwerqwdfda

The tool unlocks some drives and lists the successful and failed drive letters.
Partially succeeded. Couldn't unlock some of the drives with the supplied passkey. Contact Microsoft Support for next steps.
Couldn't find locked volumes. Verify disk received from Microsoft is connected properly and is in locked state. The tool fails to find any locked drives. Either the drives are already unlocked or not detected. Ensure that the drives are connected and are locked.

You may also see this error if you have formatted your disks. If you have formatted your disks, these are now unusable. Contact Microsoft Support for next steps.
Fatal error: Invalid parameter
Parameter name: invalid_arg
USAGE:
DataBoxDiskUnlock /PassKeys:<passkey_list_separated_by_semicolon>

Example: DataBoxDiskUnlock /PassKeys:passkey1;passkey2;passkey3
Example: DataBoxDiskUnlock /SystemCheck
Example: DataBoxDiskUnlock /Help

/PassKeys: Get this passkey from Azure DataBox Disk order. The passkey unlocks your disks.
/Help: This option provides help on cmdlet usage and examples.
/SystemCheck: This option checks if your system meets the requirements to run the tool.

Press any key to exit.
Invalid parameter entered. The only allowed parameters are /SystemCheck, /PassKey, and /Help.

Unlock issues for disks when using a Windows client

This section details some of the top issues faced during deployment of Data Box Disk when using a Windows client for data copy.

Issue: Couldn't unlock drive from BitLocker

Cause

You have used the password in the BitLocker dialog and trying to unlock the disk via the BitLocker unlock drives dialog. This wouldn't work.

Resolution

To unlock the Data Box Disks, you need to use the Data Box Disk Unlock tool and provide the password from the Azure portal. For more information, go to Tutorial: Unpack, connect, and unlock Azure Data Box Disk.

Issue: Couldn't unlock or verify some volumes. Contact Microsoft Support.

Cause

You may see the following error in the error log and are not able to unlock or verify some volumes.

Exception System.IO.FileNotFoundException: Could not load file or assembly 'Microsoft.Management.Infrastructure, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35' or one of its dependencies. The system cannot find the file specified.

This indicates that you're likely missing the appropriate version of Windows PowerShell on your Windows client.

Resolution

You can install Windows PowerShell v 5.0 and retry the operation.

If you're still not able to unlock the volumes, copy the logs from the folder that has the Data Box Disk Unlock tool and contact Microsoft Support.

Next steps