Export (0) Print
Expand All

Get-BitLockerVolume

Updated: December 14, 2012

Applies To: Windows Server 2012

Get-BitLockerVolume

Gets information about volumes that BitLocker can protect.

Syntax

Parameter Set: __AllParameterSets
Get-BitLockerVolume [[-MountPoint] <String[]> ] [ <CommonParameters>]




Detailed 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 (http://technet.microsoft.com/en-us/library/cc732774.aspx) on TechNet.

Parameters

-MountPoint<String[]>

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


Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue, ByPropertyName)

Accept Wildcard Characters?

false

<CommonParameters>

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

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • BitLockerVolume[], String[]

Outputs

The output type is the type of the objects that the cmdlet emits.

  • BitLockerVolume[]

Examples

Example 1: Get all BitLocker volumes

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


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

Example 2: Get a specific BitLocker volume

This command gets the specified 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

Related topics

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft