Table of contents
TLS
TOC
Collapse the table of content
Expand the table of content

Get-BitLockerVolume

Brian Lich|Last Updated: 3/8/2017

SYNOPSIS

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.

PARAMETERS

-MountPoint

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

Type: String[]
Parameter Sets: (All)
Aliases: 

Required: False
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

BitLockerVolume[], String[]

OUTPUTS

BitLockerVolume[]

NOTES

Add-BitLockerKeyProtector

Enable-BitLocker

Enable-BitLockerAutoUnlock

© 2017 Microsoft