Skip to content

Latest commit

 

History

History
140 lines (115 loc) · 5.91 KB

README.md

File metadata and controls

140 lines (115 loc) · 5.91 KB

xBitlocker

Build Status Azure DevOps coverage (branch) Azure DevOps tests PowerShell Gallery (with prereleases) PowerShell Gallery

This DSC module allows you to configure Bitlocker on a single disk, configure a TPM chip, or automatically enable Bitlocker on multiple disks.

Code of Conduct

This project has adopted this Code of Conduct.

Releases

For each merge to the branch master a preview release will be deployed to PowerShell Gallery. Periodically a release version tag will be pushed which will deploy a full release to PowerShell Gallery.

Contributing

Please check out common DSC Community contributing guidelines.

Requirements

This module requires that both the Bitlocker and RSAT-Feature-Tools-Bitlocker features are installed. It also requires the latest version of PowerShell (v4.0, which ships in Windows 8.1 or Windows Server 2012R2). For more information on using PowerShell 4.0 on older operating systems, Install WMF 4.0.

Description

The xBitlocker module contains the xBLAutoBitlocker, xBLBitlocker, xBLTpm DSC Resources. This DSC Module allows you to configure Bitlocker on a single disk, configure a TPM chip, or automatically enable Bitlocker on multiple disks.

Resources

xBLAutoBitlocker is used to automatically enable Bitlocker on drives of type Fixed or Removable. It does not work on Operating System drives. xBLAutoBitlocker has the following properties. Where no description is listed, properties correspond directly to Enable-Bitlocker parameters.

  • DriveType: The type of volume to auto apply Bitlocker to. Valid values are "Fixed" or "Removable"
  • PrimaryProtector: The primary protector type to be used for AutoBitlocker. Valid values are: "AdAccountOrGroupProtector", "PasswordProtector", "Pin", "RecoveryKeyProtector", "RecoveryPasswordProtector", "StartupKeyProtector", or "TpmProtector"
  • MinDiskCapacityGB: If specified, only disks this size or greater will auto apply Bitlocker
  • AutoUnlock: Whether volumes should be enabled for auto unlock using Enable-BitlockerAutoUnlock
  • AdAccountOrGroup
  • AdAccountOrGroupProtector
  • EncryptionMethod
  • HardwareEncryption
  • Password
  • PasswordProtector
  • Pin
  • RecoveryKeyPath
  • RecoveryKeyProtector
  • RecoveryPasswordProtector
  • Service
  • SkipHardwareTest
  • StartupKeyPath
  • StartupKeyProtector
  • TpmProtector
  • UsedSpaceOnly

xBLBitlocker has the following properties. Where no description is listed, properties correspond directly to Enable-Bitlocker parameters.

  • MountPoint: The MountPoint name as reported in Get-BitLockerVolume

  • PrimaryProtector: The primary protector type to be used for AutoBitlocker. Valid values are: "AdAccountOrGroupProtector", "PasswordProtector", "Pin", "RecoveryKeyProtector", "RecoveryPasswordProtector", "StartupKeyProtector", or "TpmProtector"

  • AutoUnlock: Whether volumes should be enabled for auto unlock using Enable-BitlockerAutoUnlock

  • AllowImmediateReboot: Whether the computer can be immediately rebooted after enabling Bitlocker on an OS drive. Defaults to false.

  • AdAccountOrGroup

  • AdAccountOrGroupProtector

  • EncryptionMethod

  • HardwareEncryption

  • Password

  • PasswordProtector

  • Pin

  • RecoveryKeyPath

  • RecoveryKeyProtector

  • RecoveryPasswordProtector

  • Service

  • SkipHardwareTest

  • StartupKeyPath

  • StartupKeyProtector

  • TpmProtector

  • UsedSpaceOnly

xBLTpm is used to initialize a TPM chip using Initialize-TPM. xBLTpm has the following properties.

  • Identity: A required string value which is used as a Key for the resource. The value does not matter, as long as its not empty.
  • AllowClear: Indicates that the provisioning process clears the TPM, if necessary, to move the TPM closer to complying with Windows Server 2012 standards.
  • AllowPhysicalPresence: Indicates that the provisioning process may send physical presence commands that require a user to be present in order to continue.
  • AllowImmediateReboot: Whether the computer can rebooted immediately after initializing the TPM.

Examples

This example enables Bitlocker on an Operating System drive. The example code for ConfigureBitlockerOnOSDrive is located in ConfigureBitlockerOnOSDrive.ps1.

Enables Bitlocker on an Operating System drive, and automatically enables Bitlocker on all drives of type 'Fixed'. The example code for ConfigureBitlockerAndAutoBitlocker is located in ConfigureBitlockerAndAutoBitlocker.ps1.