Freigeben über


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:"

Add-BitLockerKeyProtector

Enable-BitLocker

Enable-BitLockerAutoUnlock