Update README.md

2026-07-26 11:28:14 +00:00 · 2021-09-24 15:24:20 -04:00
parent ace4c16162
commit ed3f138035
1 changed files with 65 additions and 2 deletions
@@ -1,2 +1,65 @@
-# Decrypt-BitlockerVolume
-Provides the ability to remove Bitlocker disk encryption from all volumes located on fixed hard disks. Removable disk(s) will not be included.
+<#
+    .SYNOPSIS
+    Provides the ability to remove Bitlocker disk encryption from all volumes located on fixed hard disks. Removable disk(s) will not be included.
+          
+    .DESCRIPTION
+    By default, only the operating system volume will be decrypted. Modify the regular expression parameter(s) to achieve the desired scenario.
+    Because the "Decrypt-BitlockerVolume" command is asynchronous, a Do-Until loop will be used in order to track the decrpytion process on each volume and keep the script from exiting until the decryption is completed.
+          
+    .PARAMETER DriveTypeExpression
+    A regular expression that correctly includes values from the "DriveType" property as seen in the example below.
+
+    DriveLetter FriendlyName FileSystemType DriveType HealthStatus OperationalStatus SizeRemaining      Size
+    ----------- ------------ -------------- --------- ------------ ----------------- -------------      ----
+    C           OS           NTFS           Fixed     Healthy      OK                    164.69 GB 475.69 GB
+                WinRE_DRV    NTFS           Fixed     Healthy      OK                    503.32 MB   1000 MB
+                SYSTEM       FAT32          Fixed     Healthy      OK                    225.49 MB    256 MB
+
+    .PARAMETER DriveLetterInclusionExpression
+    A regular expression that correctly includes the desired drive letters of encrypted volumes. By default, only the operating system volume is included.
+
+    Examples:
+    All Volumes - ^[a-zA-Z]$
+    Specific Volumes - ^[C]$
+    Multiple Volumes - ^[E|H|K]$
+
+    .PARAMETER DriveLetterExclusionExpression
+    A regular expression that correctly excludes the desired drive letters of encrypted volumes. By default, only volumes without a drive letter are excluded.
+
+    Examples:
+    Specific Volumes - ^[C]$
+    Multiple Volumes - ^[E|H|K]$
+
+    .PARAMETER VolumeStatusExpression
+    A regular expression that correctly includes the bitlocker volume status of an encryptable volume.
+
+    VolumeType      Mount CapacityGB VolumeStatus           Encryption KeyProtector              AutoUnlock Protection
+                    Point                                   Percentage                           Enabled    Status    
+    ----------      ----- ---------- ------------           ---------- ------------              ---------- ----------
+    OperatingSystem C:        475.69 FullyDecrypted         0          {}                                   Off       
+
+    .PARAMETER LogDir
+    A valid folder path. If the folder does not exist, it will be created. This parameter can also be specified by the alias "LogPath".
+
+    .PARAMETER ContinueOnError
+    Ignore failures.
+          
+    .EXAMPLE
+    powershell.exe -ExecutionPolicy Bypass -NoProfile -NoLogo -File "%FolderPathContainingScript%\%ScriptName%.ps1"
+
+    .EXAMPLE
+    powershell.exe -ExecutionPolicy Bypass -NoProfile -NoLogo -File "%FolderPathContainingScript%\%ScriptName%.ps1" -ScriptParameter "%ScriptParameterValue%"
+
+    .EXAMPLE
+    powershell.exe -ExecutionPolicy Bypass -NoProfile -NoLogo -File "%FolderPathContainingScript%\%ScriptName%.ps1" -SwitchParameter
+  
+    .NOTES
+    The Disable-BitLocker cmdlet disables BitLocker Drive Encryption for a BitLocker volume. When you run this cmdlet, it removes all key protectors and begins decrypting the content of the volume.
+
+    If the volume that hosts the operating system contains any automatic unlocking keys, the cmdlet does not proceed. You can use the Clear-BitLockerAutoUnlock cmdlet to remove all automatic unlocking keys. Then you can disable BitLocker for the volume.
+
+    For an overview of BitLocker, see BitLocker Drive Encryption Overview on TechNet.
+          
+    .LINK
+    https://docs.microsoft.com/en-us/powershell/module/bitlocker/disable-bitlocker?view=windowsserver2019-ps
+#>