Get-BitLockerVolume
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 (https://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 (https://go.microsoft.com/fwlink/p/?LinkID=113216).
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
Example 2: Get a specific BitLocker volume
This command gets the specified BitLocker volume.
PS C:\> Get-BitLockerVolume -MountPoint "E:"