< Back

Get-BitLockerVolume

Tue Jan 29, 2019 10:13 pm

NAME Get-BitLockerVolume



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





PARAMETERS

-MountPoint <String[]>

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



Required? false

Position? 1

Default value

Accept pipeline input? True (ByValue, ByPropertyName)

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

BitLockerVolume[], String[]







OUTPUTS

BitLockerVolume[]







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.



RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?linkid=287654

Add-BitLockerKeyProtector

Enable-BitLocker

Enable-BitLockerAutoUnlock