Get-BitLockerVolume

Gets information about volumes that BitLocker can protect.

Syntax

Get-BitLockerVolume
   [[-MountPoint] <String[]>]
   [<CommonParameters>]

Description

The Get-BitLockerVolume cmdlet gets information about volumes that BitLocker Drive Encryption can protect. You can specify a BitLocker volume by drive letter, followed by a colon (C:, E:). If you do not specify a drive letter, this cmdlet gets all volumes for the current computer.

You can use this cmdlet to get BitLocker volumes to use with other cmdlets, such as the Enable-BitLocker cmdlet or the Add-BitLockerKeyProtector cmdlet. You can also use this cmdlet to view the following information about a BitLocker volume:

  • VolumeType. Data or Operating System.
  • Mount Point. Drive letter.
  • CapacityGB. Size of drive.
  • VolumeStatus. Whether BitLocker currently protects some, all, or none of the data on the volume.
  • Encryption Percentage. Percent of the volume protected by BitLocker.
  • KeyProtector. Type of key protector or protectors.
  • AutoUnlock Enabled. Whether BitLocker uses automatic unlocking for the volume.
  • Protection Status. Whether BitLocker currently uses a key protector to encrypt the volume encryption key.

For an overview of BitLocker, see BitLocker Drive Encryption Overview on TechNet.

Examples

Example 1: Get all BitLocker volumes

PS C:\> Get-BitLockerVolume 

VolumeType      Mount CapacityGB VolumeStatus           Encryption KeyProtector              AutoUnlock Protection
                Point                                   Percentage                           Enabled    Status
----------      ----- ---------- ------------           ---------- ------------              ---------- ----------
Data            D:        931.51 EncryptionInProgress   1          {RecoveryPassword, Pas...            Off
Data            E:        928.83 FullyDecrypted         0          {}                                   Off
OperatingSystem C:        232.54 FullyDecrypted         0          {Tpm}                                Off
Data            F:          0.98 FullyDecrypted         0          {}                                   Off
Data            G:          1.70 FullyDecrypted         0          {}                                   Off

This command gets all the BitLocker volumes for the current computer.

Example 2: Get a specific BitLocker volume

PS C:\> Get-BitLockerVolume -MountPoint "E:"

VolumeType      Mount CapacityGB VolumeStatus           Encryption KeyProtector              AutoUnlock Protection
                Point                                   Percentage                           Enabled    Status
----------      ----- ---------- ------------           ---------- ------------              ---------- ----------
Data            E:        928.83 FullyDecrypted         0          {}                                   Off

This command gets the specified BitLocker volume.

Optional Parameters

-MountPoint

Specifies an array of drive letters. This cmdlet gets these BitLocker volumes.

Type:String[]
Position:0
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
Accept wildcard characters:False

Inputs

BitLockerVolume[], String[]

Outputs

BitLockerVolume[]