From 4a6d63b5126172bc1b593fd9d642ad072d88df76 Mon Sep 17 00:00:00 2001 From: skycommand <17097175+skycommand@users.noreply.github.com> Date: Mon, 1 Jan 2024 23:52:37 +0330 Subject: [PATCH 01/13] Update Add-BitLockerKeyProtector.md More info on Recovery Password. --- .../bitlocker/Add-BitLockerKeyProtector.md | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/docset/winserver2022-ps/bitlocker/Add-BitLockerKeyProtector.md b/docset/winserver2022-ps/bitlocker/Add-BitLockerKeyProtector.md index 8c3aec7fa9..7ef886b30f 100644 --- a/docset/winserver2022-ps/bitlocker/Add-BitLockerKeyProtector.md +++ b/docset/winserver2022-ps/bitlocker/Add-BitLockerKeyProtector.md @@ -295,10 +295,19 @@ Accept wildcard characters: False ``` ### -RecoveryPassword -Specifies a recovery password. +Specifies a recovery password. The cmdlet adds the password specified or created as a protector for the volume encryption key. If you do not specify this parameter, the cmdlet creates a random password. -You can enter a 48 digit password. -The cmdlet adds the password specified or created as a protector for the volume encryption key. + +A recovery password has rigid requirements. It must consist of 48 digits. Each 6 must be divisible by 11. For example, the +following is acceptable: + + '147279-525107-204677-117612-367510-356554-273911-527274' + +The following is **not** acceptable: + + '702510-071786-013337-543770-555603-414075-635673-114355' + +In the example above, only the second segment is divisible by 11. The others are not. ```yaml Type: String From c14f2cf15b996601cb3e29f046b713f7f853de72 Mon Sep 17 00:00:00 2001 From: skycommand <17097175+skycommand@users.noreply.github.com> Date: Mon, 1 Jan 2024 23:59:10 +0330 Subject: [PATCH 02/13] Update Add-BitLockerKeyProtector.md Added essentials info about the Recovery Password. --- .../winserver2022-ps/bitlocker/Add-BitLockerKeyProtector.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docset/winserver2022-ps/bitlocker/Add-BitLockerKeyProtector.md b/docset/winserver2022-ps/bitlocker/Add-BitLockerKeyProtector.md index 7ef886b30f..511482b865 100644 --- a/docset/winserver2022-ps/bitlocker/Add-BitLockerKeyProtector.md +++ b/docset/winserver2022-ps/bitlocker/Add-BitLockerKeyProtector.md @@ -296,9 +296,9 @@ Accept wildcard characters: False ### -RecoveryPassword Specifies a recovery password. The cmdlet adds the password specified or created as a protector for the volume encryption key. -If you do not specify this parameter, the cmdlet creates a random password. +If you do not specify this parameter (but specify `-RecoveryPasswordProtector`, the cmdlet creates a random recovery password. -A recovery password has rigid requirements. It must consist of 48 digits. Each 6 must be divisible by 11. For example, the +A recovery password has rigid requirements. It must consist of 48 digits. Each six must be divisible by 11. For example, the following is acceptable: '147279-525107-204677-117612-367510-356554-273911-527274' From bd2c29cbac2c63fbff4e986d3d1c7579efb0acf4 Mon Sep 17 00:00:00 2001 From: skycommand <17097175+skycommand@users.noreply.github.com> Date: Mon, 1 Jan 2024 23:59:19 +0330 Subject: [PATCH 03/13] Update Enable-BitLocker.md Added essentials info about the Recovery Password. --- .../bitlocker/Enable-BitLocker.md | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/docset/winserver2022-ps/bitlocker/Enable-BitLocker.md b/docset/winserver2022-ps/bitlocker/Enable-BitLocker.md index eecff8ce70..922d6b8546 100644 --- a/docset/winserver2022-ps/bitlocker/Enable-BitLocker.md +++ b/docset/winserver2022-ps/bitlocker/Enable-BitLocker.md @@ -395,10 +395,19 @@ Accept wildcard characters: False ### -RecoveryPassword -Specifies a recovery password. -If you do not specify this parameter, but you do include the *RecoveryPasswordProtector* parameter, the cmdlet creates a random password. -You can enter a 48-digit password. -The password specified or created acts as a protector for the volume encryption key. +Specifies a recovery password. The cmdlet adds the password specified or created as a protector for the volume encryption key. +If you do not specify this parameter (but specify `-RecoveryPasswordProtector`, the cmdlet creates a random recovery password. + +A recovery password has rigid requirements. It must consist of 48 digits. Each six must be divisible by 11. For example, the +following is acceptable: + + '147279-525107-204677-117612-367510-356554-273911-527274' + +The following is **not** acceptable: + + '702510-071786-013337-543770-555603-414075-635673-114355' + +In the example above, only the second segment is divisible by 11. The others are not. ```yaml Type: String From 9bbc5d1a13ebd5faf7e2d64fd221130a7f09084a Mon Sep 17 00:00:00 2001 From: skycommand <17097175+skycommand@users.noreply.github.com> Date: Tue, 2 Jan 2024 00:03:24 +0330 Subject: [PATCH 04/13] Update Enable-BitLocker.md Added essentials info about the Recovery Password. --- .../bitlocker/Enable-BitLocker.md | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/docset/winserver2019-ps/bitlocker/Enable-BitLocker.md b/docset/winserver2019-ps/bitlocker/Enable-BitLocker.md index 7e389edee6..ef98da5ab8 100644 --- a/docset/winserver2019-ps/bitlocker/Enable-BitLocker.md +++ b/docset/winserver2019-ps/bitlocker/Enable-BitLocker.md @@ -394,11 +394,19 @@ Accept wildcard characters: False ``` ### -RecoveryPassword +Specifies a recovery password. The cmdlet adds the password specified or created as a protector for the volume encryption key. +If you do not specify this parameter (but specify `-RecoveryPasswordProtector`, the cmdlet creates a random recovery password. -Specifies a recovery password. -If you do not specify this parameter, but you do include the *RecoveryPasswordProtector* parameter, the cmdlet creates a random password. -You can enter a 48-digit password. -The password specified or created acts as a protector for the volume encryption key. +A recovery password has rigid requirements. It must consist of 48 digits. Each six must be divisible by 11. For example, the +following is acceptable: + + '147279-525107-204677-117612-367510-356554-273911-527274' + +The following is **not** acceptable: + + '702510-071786-013337-543770-555603-414075-635673-114355' + +In the example above, only the second segment is divisible by 11. The others are not. ```yaml Type: String From 3175e0ad8067b420109361d6e3e16e8655f5321f Mon Sep 17 00:00:00 2001 From: skycommand <17097175+skycommand@users.noreply.github.com> Date: Tue, 2 Jan 2024 00:03:30 +0330 Subject: [PATCH 05/13] Update Add-BitLockerKeyProtector.md Added essentials info about the Recovery Password. --- .../bitlocker/Add-BitLockerKeyProtector.md | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/docset/winserver2019-ps/bitlocker/Add-BitLockerKeyProtector.md b/docset/winserver2019-ps/bitlocker/Add-BitLockerKeyProtector.md index afca7ea9e7..8066f4d379 100644 --- a/docset/winserver2019-ps/bitlocker/Add-BitLockerKeyProtector.md +++ b/docset/winserver2019-ps/bitlocker/Add-BitLockerKeyProtector.md @@ -295,10 +295,19 @@ Accept wildcard characters: False ``` ### -RecoveryPassword -Specifies a recovery password. -If you do not specify this parameter, the cmdlet creates a random password. -You can enter a 48 digit password. -The cmdlet adds the password specified or created as a protector for the volume encryption key. +Specifies a recovery password. The cmdlet adds the password specified or created as a protector for the volume encryption key. +If you do not specify this parameter (but specify `-RecoveryPasswordProtector`, the cmdlet creates a random recovery password. + +A recovery password has rigid requirements. It must consist of 48 digits. Each six must be divisible by 11. For example, the +following is acceptable: + + '147279-525107-204677-117612-367510-356554-273911-527274' + +The following is **not** acceptable: + + '702510-071786-013337-543770-555603-414075-635673-114355' + +In the example above, only the second segment is divisible by 11. The others are not. ```yaml Type: String From 30f3a9bcab6bc69a95889d602ef7163a8ee5e051 Mon Sep 17 00:00:00 2001 From: skycommand <17097175+skycommand@users.noreply.github.com> Date: Tue, 2 Jan 2024 00:06:42 +0330 Subject: [PATCH 06/13] Update Enable-BitLocker.md Added essentials info about the Recovery Password. --- .../bitlocker/Enable-BitLocker.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docset/winserver2012r2-ps/bitlocker/Enable-BitLocker.md b/docset/winserver2012r2-ps/bitlocker/Enable-BitLocker.md index f8e6124246..70bdd75511 100644 --- a/docset/winserver2012r2-ps/bitlocker/Enable-BitLocker.md +++ b/docset/winserver2012r2-ps/bitlocker/Enable-BitLocker.md @@ -395,12 +395,19 @@ Accept wildcard characters: False ### -RecoveryPassword -Specifies a recovery password. -If you do not specify this parameter but include the *RecoveryPasswordProtector* parameter, the cmdlet creates a random password. +Specifies a recovery password. The cmdlet adds the password specified or created as a protector for the volume encryption key. +If you do not specify this parameter (but specify `-RecoveryPasswordProtector`, the cmdlet creates a random recovery password. -You can enter a 48-digit password. +A recovery password has rigid requirements. It must consist of 48 digits. Each six must be divisible by 11. For example, the +following is acceptable: -The password specified or created acts as a protector for the volume encryption key. + '147279-525107-204677-117612-367510-356554-273911-527274' + +The following is **not** acceptable: + + '702510-071786-013337-543770-555603-414075-635673-114355' + +In the example above, only the second segment is divisible by 11. The others are not. ```yaml Type: String From 4a2470f5e1810ebe1902148dbc610f883a98c604 Mon Sep 17 00:00:00 2001 From: skycommand <17097175+skycommand@users.noreply.github.com> Date: Tue, 2 Jan 2024 00:06:47 +0330 Subject: [PATCH 07/13] Update Add-BitLockerKeyProtector.md Added essentials info about the Recovery Password. --- .../bitlocker/Add-BitLockerKeyProtector.md | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/docset/winserver2012r2-ps/bitlocker/Add-BitLockerKeyProtector.md b/docset/winserver2012r2-ps/bitlocker/Add-BitLockerKeyProtector.md index 26aa9b4d4b..09d54ab696 100644 --- a/docset/winserver2012r2-ps/bitlocker/Add-BitLockerKeyProtector.md +++ b/docset/winserver2012r2-ps/bitlocker/Add-BitLockerKeyProtector.md @@ -294,10 +294,19 @@ Accept wildcard characters: False ``` ### -RecoveryPassword -Specifies a recovery password. -If you do not specify this parameter, the cmdlet creates a random password. -You can enter a 48 digit password. -The cmdlet adds the password specified or created as a protector for the volume encryption key. +Specifies a recovery password. The cmdlet adds the password specified or created as a protector for the volume encryption key. +If you do not specify this parameter (but specify `-RecoveryPasswordProtector`, the cmdlet creates a random recovery password. + +A recovery password has rigid requirements. It must consist of 48 digits. Each six must be divisible by 11. For example, the +following is acceptable: + + '147279-525107-204677-117612-367510-356554-273911-527274' + +The following is **not** acceptable: + + '702510-071786-013337-543770-555603-414075-635673-114355' + +In the example above, only the second segment is divisible by 11. The others are not. ```yaml Type: String From 60fef0ddb18ec8ff56bb604f30ea9b7909ce8584 Mon Sep 17 00:00:00 2001 From: skycommand <17097175+skycommand@users.noreply.github.com> Date: Tue, 2 Jan 2024 00:06:51 +0330 Subject: [PATCH 08/13] Update Add-BitLockerKeyProtector.md Added essentials info about the Recovery Password. --- .../bitlocker/Add-BitLockerKeyProtector.md | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/docset/winserver2012-ps/bitlocker/Add-BitLockerKeyProtector.md b/docset/winserver2012-ps/bitlocker/Add-BitLockerKeyProtector.md index ccfc0f6223..c313af14f1 100644 --- a/docset/winserver2012-ps/bitlocker/Add-BitLockerKeyProtector.md +++ b/docset/winserver2012-ps/bitlocker/Add-BitLockerKeyProtector.md @@ -275,10 +275,19 @@ Accept wildcard characters: False ``` ### -RecoveryPassword -Specifies a recovery password. -If you do not specify this parameter, the cmdlet creates a random password. -You can enter a 48 digit password. -The cmdlet adds the password specified or created as a protector for the volume encryption key. +Specifies a recovery password. The cmdlet adds the password specified or created as a protector for the volume encryption key. +If you do not specify this parameter (but specify `-RecoveryPasswordProtector`, the cmdlet creates a random recovery password. + +A recovery password has rigid requirements. It must consist of 48 digits. Each six must be divisible by 11. For example, the +following is acceptable: + + '147279-525107-204677-117612-367510-356554-273911-527274' + +The following is **not** acceptable: + + '702510-071786-013337-543770-555603-414075-635673-114355' + +In the example above, only the second segment is divisible by 11. The others are not. ```yaml Type: String From f6fcfa2be7083703eb1b411a840b8931b8fa6b74 Mon Sep 17 00:00:00 2001 From: skycommand <17097175+skycommand@users.noreply.github.com> Date: Tue, 2 Jan 2024 00:06:57 +0330 Subject: [PATCH 09/13] Update Enable-BitLocker.md Added essentials info about the Recovery Password. --- .../bitlocker/Enable-BitLocker.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docset/winserver2012-ps/bitlocker/Enable-BitLocker.md b/docset/winserver2012-ps/bitlocker/Enable-BitLocker.md index 7962836012..b03b8983a1 100644 --- a/docset/winserver2012-ps/bitlocker/Enable-BitLocker.md +++ b/docset/winserver2012-ps/bitlocker/Enable-BitLocker.md @@ -395,12 +395,19 @@ Accept wildcard characters: False ### -RecoveryPassword -Specifies a recovery password. -If you do not specify this parameter but include the *RecoveryPasswordProtector* parameter, the cmdlet creates a random password. +Specifies a recovery password. The cmdlet adds the password specified or created as a protector for the volume encryption key. +If you do not specify this parameter (but specify `-RecoveryPasswordProtector`, the cmdlet creates a random recovery password. -You can enter a 48-digit password. +A recovery password has rigid requirements. It must consist of 48 digits. Each six must be divisible by 11. For example, the +following is acceptable: -The password specified or created acts as a protector for the volume encryption key. + '147279-525107-204677-117612-367510-356554-273911-527274' + +The following is **not** acceptable: + + '702510-071786-013337-543770-555603-414075-635673-114355' + +In the example above, only the second segment is divisible by 11. The others are not. ```yaml Type: String From f844fae795b2b11ebac3ef75005277ba9f3b5095 Mon Sep 17 00:00:00 2001 From: skycommand <17097175+skycommand@users.noreply.github.com> Date: Tue, 2 Jan 2024 00:06:59 +0330 Subject: [PATCH 10/13] Update Enable-BitLocker.md Added essentials info about the Recovery Password. --- .../bitlocker/Enable-BitLocker.md | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/docset/winserver2016-ps/bitlocker/Enable-BitLocker.md b/docset/winserver2016-ps/bitlocker/Enable-BitLocker.md index c15d1ef4c2..91e1e94ec6 100644 --- a/docset/winserver2016-ps/bitlocker/Enable-BitLocker.md +++ b/docset/winserver2016-ps/bitlocker/Enable-BitLocker.md @@ -395,10 +395,19 @@ Accept wildcard characters: False ### -RecoveryPassword -Specifies a recovery password. -If you do not specify this parameter, but you do include the *RecoveryPasswordProtector* parameter, the cmdlet creates a random password. -You can enter a 48-digit password. -The password specified or created acts as a protector for the volume encryption key. +Specifies a recovery password. The cmdlet adds the password specified or created as a protector for the volume encryption key. +If you do not specify this parameter (but specify `-RecoveryPasswordProtector`, the cmdlet creates a random recovery password. + +A recovery password has rigid requirements. It must consist of 48 digits. Each six must be divisible by 11. For example, the +following is acceptable: + + '147279-525107-204677-117612-367510-356554-273911-527274' + +The following is **not** acceptable: + + '702510-071786-013337-543770-555603-414075-635673-114355' + +In the example above, only the second segment is divisible by 11. The others are not. ```yaml Type: String From 5d180511b4894faa9a280d1e05ea04f234bb5934 Mon Sep 17 00:00:00 2001 From: skycommand <17097175+skycommand@users.noreply.github.com> Date: Tue, 2 Jan 2024 00:07:04 +0330 Subject: [PATCH 11/13] Update Add-BitLockerKeyProtector.md Added essentials info about the Recovery Password. --- .../bitlocker/Add-BitLockerKeyProtector.md | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/docset/winserver2016-ps/bitlocker/Add-BitLockerKeyProtector.md b/docset/winserver2016-ps/bitlocker/Add-BitLockerKeyProtector.md index 64cc096d55..cd89e1385b 100644 --- a/docset/winserver2016-ps/bitlocker/Add-BitLockerKeyProtector.md +++ b/docset/winserver2016-ps/bitlocker/Add-BitLockerKeyProtector.md @@ -295,10 +295,19 @@ Accept wildcard characters: False ``` ### -RecoveryPassword -Specifies a recovery password. -If you do not specify this parameter, the cmdlet creates a random password. -You can enter a 48 digit password. -The cmdlet adds the password specified or created as a protector for the volume encryption key. +Specifies a recovery password. The cmdlet adds the password specified or created as a protector for the volume encryption key. +If you do not specify this parameter (but specify `-RecoveryPasswordProtector`, the cmdlet creates a random recovery password. + +A recovery password has rigid requirements. It must consist of 48 digits. Each six must be divisible by 11. For example, the +following is acceptable: + + '147279-525107-204677-117612-367510-356554-273911-527274' + +The following is **not** acceptable: + + '702510-071786-013337-543770-555603-414075-635673-114355' + +In the example above, only the second segment is divisible by 11. The others are not. ```yaml Type: String From c6e02c3b9638576c4b49ac0be87d21f7176fa3f7 Mon Sep 17 00:00:00 2001 From: skycommand <17097175+skycommand@users.noreply.github.com> Date: Sun, 22 Nov 2026 05:19:58 +0330 Subject: [PATCH 12/13] Conflict resolution result --- .../bitlocker/Add-BitLockerKeyProtector.md | 475 ------------- .../bitlocker/Enable-BitLocker.md | 629 ------------------ 2 files changed, 1104 deletions(-) delete mode 100644 docset/winserver2012-ps/bitlocker/Add-BitLockerKeyProtector.md delete mode 100644 docset/winserver2012r2-ps/bitlocker/Enable-BitLocker.md diff --git a/docset/winserver2012-ps/bitlocker/Add-BitLockerKeyProtector.md b/docset/winserver2012-ps/bitlocker/Add-BitLockerKeyProtector.md deleted file mode 100644 index c313af14f1..0000000000 --- a/docset/winserver2012-ps/bitlocker/Add-BitLockerKeyProtector.md +++ /dev/null @@ -1,475 +0,0 @@ ---- -external help file: Bitlocker_Cmdlets.xml -Module Name: BitLocker -online version: https://learn.microsoft.com/powershell/module/bitlocker/add-bitlockerkeyprotector?view=windowsserver2012-ps&wt.mc_id=ps-gethelp -schema: 2.0.0 ---- - -# Add-BitLockerKeyProtector - -## SYNOPSIS -Adds a key protector for a BitLocker volume. - -## SYNTAX - -### UNNAMED_PARAMETER_SET_1 -``` -Add-BitLockerKeyProtector [-ADAccountOrGroup] [-Service] [-ADAccountOrGroupProtector] [-Confirm] - [-WhatIf] -``` - -### UNNAMED_PARAMETER_SET_2 -``` -Add-BitLockerKeyProtector [-MountPoint] [-Confirm] [-WhatIf] -``` - -### UNNAMED_PARAMETER_SET_3 -``` -Add-BitLockerKeyProtector [[-Password] ] [-PasswordProtector] [-Confirm] [-WhatIf] -``` - -### UNNAMED_PARAMETER_SET_4 -``` -Add-BitLockerKeyProtector [-StartupKeyPath] [[-Pin] ] [-TpmAndPinAndStartupKeyProtector] - [-Confirm] [-WhatIf] -``` - -### UNNAMED_PARAMETER_SET_5 -``` -Add-BitLockerKeyProtector [[-Pin] ] [-TpmAndPinProtector] [-Confirm] [-WhatIf] -``` - -### UNNAMED_PARAMETER_SET_6 -``` -Add-BitLockerKeyProtector [-RecoveryKeyPath] [-RecoveryKeyProtector] [-Confirm] [-WhatIf] -``` - -### UNNAMED_PARAMETER_SET_7 -``` -Add-BitLockerKeyProtector [[-RecoveryPassword] ] [-RecoveryPasswordProtector] [-Confirm] [-WhatIf] -``` - -### UNNAMED_PARAMETER_SET_8 -``` -Add-BitLockerKeyProtector [-StartupKeyPath] [-StartupKeyProtector] [-Confirm] [-WhatIf] -``` - -### UNNAMED_PARAMETER_SET_9 -``` -Add-BitLockerKeyProtector [-StartupKeyPath] [-TpmAndStartupKeyProtector] [-Confirm] [-WhatIf] -``` - -### UNNAMED_PARAMETER_SET_10 -``` -Add-BitLockerKeyProtector [-TpmProtector] [-Confirm] [-WhatIf] -``` - -## DESCRIPTION -The **Add-BitLockerKeyProtector** cmdlet adds a protector for the volume key of the volume protected with BitLocker Drive Encryption. - -When a user accesses a drive protected by BitLocker, such as when starting a computer, BitLocker requests the relevant key protector. -For example, the user can enter a PIN or provide a USB drive that contains a key. -BitLocker retrieves the encryption key and uses it to read data from the drive. - -You can use one of the following methods or combinations of methods for a key protector: - -- Trusted Platform Module (TPM). -BitLocker uses the computer's TPM to protect the encryption key. -If you specify this protector, users can access the encrypted drive as long as it is connected to the system board that hosts the TPM and the system boot integrity is intact. -In general, TPM-based protectors can only be associated to an operating system volume. -- TPM and Personal Identification Number (PIN). -BitLocker uses a combination of the TPM and a user-supplied PIN. -A PIN is four to twenty digits or, if you allow enhanced PINs, four to twenty letters, symbols, spaces, or numbers. -- TPM, PIN, and startup key. -BitLocker uses a combination of the TPM, a user-supplied PIN, and input from of a USB memory device that contains an external key. -- TPM and startup key. -BitLocker uses a combination of the TPM and input from of a USB memory device. -- Startup key. -BitLocker uses input from of a USB memory device that contains the external key. -- Password. -BitLocker uses a password. -- Recovery key. -BitLocker uses a recovery key stored as a specified file in a USB memory device. -- Recovery password. -BitLocker uses a recovery password. -- Active Directory Domain Services (AD DS) account. -BitLocker uses domain authentication to unlock data volumes. -Operating system volumes cannot use this type of key protector. - -You can add only one of these methods or combinations at a time, but you can run this cmdlet more than once on a volume. - -Adding a key protector is a single operation; for example, adding a startup key protector to a volume that uses the TPM and PIN combination as a key protector results in two key protectors, not a single key protector that uses TPM, PIN, and startup key. -Instead, add a protector that uses TPM, PIN, and startup key and then remove the TPM and PIN protector by using the Remove-BitLockerKeyProtector cmdlet. - -For a password or PIN key protector, specify a secure string. -You can use the **ConvertTo-SecureString** cmdlet to create a secure string. -You can use secure strings in a script and still maintain confidentiality of passwords. - -This cmdlet returns a BitLocker volume object. -If you choose recovery password as your key protector but do not specify a 48-digit recovery password, this cmdlet creates a random 48-bit recovery password. -The cmdlet stores the password as the **RecoveryPassword** field of the **KeyProtector** attribute of the BitLocker volume object. - -If you use startup key or recovery key as part of your key protector, provide a path to store the key. -This cmdlet stores the name of the file that contains the key in the **KeyFileName** field of the **KeyProtector** field in the BitLocker volume object. - -For an overview of BitLocker, see BitLocker Drive Encryption Overviewhttp://technet.microsoft.com/en-us/library/cc732774.aspx (http://technet.microsoft.com/en-us/library/cc732774.aspx) on TechNet. - -## EXAMPLES - -### Example 1: Add key protector -``` -PS C:\>$SecureString = ConvertTo-SecureString "1234" -AsPlainText -Force PS C:\>Add-BitLockerProtector -MountPoint "C:" -Pin $SecureString -TPMandPinProtector -``` - -This example adds a combination of the TPM and a PIN as key protector for the BitLocker volume identified with the drive letter C:. - -The first command uses the **ConvertTo-SecureString** cmdlet to create a secure string that contains a PIN and saves that string in the $SecureString variable. -For more information about the **ConvertTo-SecureString** cmdlet, type `Get-Help ConvertTo-SecureString`. - -The second command adds a protector to the BitLocker volume that has the drive letter C:. -The command specifies that this volume uses a combination of the TPM and the PIN as key protector and provides the PIN saved in the $SecureString variable. - -### Example 2: Add a recovery key for all BitLocker volumes -``` -PS C:\>Get-BitLockerVolume | Add-BitLockerKeyProtector -RecoveryKeyPath "E:\Recovery\" -RecoveryKeyProtector -``` - -This command gets all the BitLocker volumes for the current computer and passes them to the Add-BitLockerKeyProtector**** cmdlet by using the pipe operator. -This cmdlet specifies a path to a folder where the randomly generated recovery key will be stored and indicates that these volumes use a recovery key as a key protector. - -### Example 3: Add credentials as a key protector -``` -PS C:\>Add-BitLockerKeyProtector -MountPoint "C:" -AdAccountOrGroup "Western\SarahJones" -AdAccountOrGroupProtector -``` - -This command adds an AD DS account key protector to the BitLocker volume specified by the **MountPoint** parameter. -The command specifies an account and specifies that BitLocker uses user credentials as a key protector. -When a user accesses this volume, BitLocker prompts for credentials for the user account Western\SarahJones. - -## PARAMETERS - -### -ADAccountOrGroup -Specifies an account using the format **Domain\User**. -This cmdlet adds the account you specify as a key protector for the volume encryption key. - -```yaml -Type: String -Parameter Sets: UNNAMED_PARAMETER_SET_1 -Aliases: sid - -Required: True -Position: 2 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -ADAccountOrGroupProtector -Indicates that BitLocker uses an AD DS account as a protector for the volume encryption key. - -```yaml -Type: SwitchParameter -Parameter Sets: UNNAMED_PARAMETER_SET_1 -Aliases: sidp - -Required: True -Position: Named -Default value: False -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -MountPoint -Specifies an array of drive letters or BitLocker volume objects. -This cmdlet adds a key protector to the volumes specified. -To obtain a BitLocker volume object, use the Get-BitLockerVolume cmdlet. - -```yaml -Type: String[] -Parameter Sets: UNNAMED_PARAMETER_SET_2 -Aliases: - -Required: True -Position: 1 -Default value: None -Accept pipeline input: True (ByValue, ByPropertyName) -Accept wildcard characters: False -``` - -### -Password -Specifies a secure string object that contains a password. -The cmdlet adds the password specified as a protector for the volume encryption key. - -```yaml -Type: SecureString -Parameter Sets: UNNAMED_PARAMETER_SET_3 -Aliases: pw - -Required: False -Position: 2 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -PasswordProtector -Indicates that BitLocker uses a password as a protector for the volume encryption key. - -```yaml -Type: SwitchParameter -Parameter Sets: UNNAMED_PARAMETER_SET_3 -Aliases: pwp - -Required: True -Position: Named -Default value: False -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -Pin -Specifies a secure string object that contains a PIN. -The cmdlet adds the PIN specified, with other data, as a protector for the volume encryption key. - -```yaml -Type: SecureString -Parameter Sets: UNNAMED_PARAMETER_SET_4, UNNAMED_PARAMETER_SET_5 -Aliases: p - -Required: False -Position: 3 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -RecoveryKeyPath -Specifies a path to a folder. -This cmdlet adds a randomly generated recovery key as a protector for the volume encryption key and stores it in the specified path. - -```yaml -Type: String -Parameter Sets: UNNAMED_PARAMETER_SET_6 -Aliases: rk - -Required: True -Position: 2 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -RecoveryKeyProtector -Indicates that BitLocker uses a recovery key as a protector for the volume encryption key. - -```yaml -Type: SwitchParameter -Parameter Sets: UNNAMED_PARAMETER_SET_6 -Aliases: rkp - -Required: True -Position: Named -Default value: False -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -RecoveryPassword -Specifies a recovery password. The cmdlet adds the password specified or created as a protector for the volume encryption key. -If you do not specify this parameter (but specify `-RecoveryPasswordProtector`, the cmdlet creates a random recovery password. - -A recovery password has rigid requirements. It must consist of 48 digits. Each six must be divisible by 11. For example, the -following is acceptable: - - '147279-525107-204677-117612-367510-356554-273911-527274' - -The following is **not** acceptable: - - '702510-071786-013337-543770-555603-414075-635673-114355' - -In the example above, only the second segment is divisible by 11. The others are not. - -```yaml -Type: String -Parameter Sets: UNNAMED_PARAMETER_SET_7 -Aliases: rp - -Required: False -Position: 2 -Default value: False -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -RecoveryPasswordProtector -Indicates that BitLocker uses a recovery password as a protector for the volume encryption key. - -```yaml -Type: SwitchParameter -Parameter Sets: UNNAMED_PARAMETER_SET_7 -Aliases: rpp - -Required: True -Position: Named -Default value: False -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -Service -Indicates that the system account for this computer unlocks the encrypted volume. - -```yaml -Type: SwitchParameter -Parameter Sets: UNNAMED_PARAMETER_SET_1 -Aliases: - -Required: False -Position: Named -Default value: False -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -StartupKeyPath -Specifies a path to a startup key. -The cmdlet adds the key stored in the specified path as a protector for the volume encryption key. - -```yaml -Type: String -Parameter Sets: UNNAMED_PARAMETER_SET_4, UNNAMED_PARAMETER_SET_8, UNNAMED_PARAMETER_SET_9 -Aliases: sk - -Required: True -Position: 2 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -StartupKeyProtector -Indicates that BitLocker uses a startup key as a protector for the volume encryption key. - -```yaml -Type: SwitchParameter -Parameter Sets: UNNAMED_PARAMETER_SET_8 -Aliases: skp - -Required: True -Position: Named -Default value: False -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -TpmAndPinAndStartupKeyProtector -Indicates that BitLocker uses a combination of TPM, a PIN, and a startup key as a protector for the volume encryption key. - -```yaml -Type: SwitchParameter -Parameter Sets: UNNAMED_PARAMETER_SET_4 -Aliases: tpskp - -Required: True -Position: Named -Default value: False -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -TpmAndPinProtector -Indicates that BitLocker uses a combination of TPM and a PIN as a protector for the volume encryption key. - -```yaml -Type: SwitchParameter -Parameter Sets: UNNAMED_PARAMETER_SET_5 -Aliases: tpp - -Required: True -Position: Named -Default value: False -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -TpmAndStartupKeyProtector -Indicates that BitLocker uses a combination of TPM and a startup key as a protector for the volume encryption key. - -```yaml -Type: SwitchParameter -Parameter Sets: UNNAMED_PARAMETER_SET_9 -Aliases: tskp - -Required: True -Position: Named -Default value: False -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -TpmProtector -Indicates that BitLocker uses TPM as a protector for the volume encryption key. - -```yaml -Type: SwitchParameter -Parameter Sets: UNNAMED_PARAMETER_SET_10 -Aliases: tpmp - -Required: True -Position: Named -Default value: False -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -Confirm -Prompts you for confirmation before running the cmdlet. - -```yaml -Type: SwitchParameter -Parameter Sets: (All) -Aliases: - -Required: False -Position: Named -Default value: False -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -WhatIf -Shows what would happen if the cmdlet runs. -The cmdlet is not run. - -```yaml -Type: SwitchParameter -Parameter Sets: (All) -Aliases: - -Required: False -Position: Named -Default value: False -Accept pipeline input: False -Accept wildcard characters: False -``` - -## INPUTS - -### BitLockerVolume[], string[] - -## OUTPUTS - -### BitLockerVolume[] - -## NOTES - -## RELATED LINKS - -[Backup-BitLockerKeyProtector](./Backup-BitLockerKeyProtector.md) - -[Remove-BitLockerKeyProtector](./Remove-BitLockerKeyProtector.md) - -[Get-BitLockerVolume](./Get-BitLockerVolume.md) - -[Enable-BitLocker](./Enable-BitLocker.md) - diff --git a/docset/winserver2012r2-ps/bitlocker/Enable-BitLocker.md b/docset/winserver2012r2-ps/bitlocker/Enable-BitLocker.md deleted file mode 100644 index 70bdd75511..0000000000 --- a/docset/winserver2012r2-ps/bitlocker/Enable-BitLocker.md +++ /dev/null @@ -1,629 +0,0 @@ ---- -description: Use this topic to help manage Windows and Windows Server technologies with Windows PowerShell. -external help file: BitLocker-help.xml -Module Name: BitLocker -ms.date: 12/14/2021 -online version: https://learn.microsoft.com/powershell/module/bitlocker/enable-bitlocker?view=windowsserver2012r2-ps&wt.mc_id=ps-gethelp -schema: 2.0.0 -title: Enable-BitLocker ---- - -# Enable-BitLocker - -## SYNOPSIS - -Enables BitLocker Drive Encryption for a volume. - -## SYNTAX - -### PasswordProtector - -```PowerShell -Enable-BitLocker [-MountPoint] -PasswordProtector [-Password] -[-EncryptionMethod ] [-HardwareEncryption] -[-SkipHardwareTest] [-UsedSpaceOnly][-WhatIf] [-Confirm] [] -``` - -### RecoveryPasswordProtector - -```PowerShell -Enable-BitLocker [-MountPoint] -RecoveryPasswordProtector [[-RecoveryPassword] ] -[-EncryptionMethod ] [-HardwareEncryption] -[-SkipHardwareTest] [-UsedSpaceOnly] [-WhatIf] [-Confirm] [] -``` - -### StartupKeyProtector - -```PowerShell -Enable-BitLocker [-MountPoint] -StartupKeyProtector [-StartupKeyPath] -[-EncryptionMethod ] [-HardwareEncryption] -[-SkipHardwareTest] [-UsedSpaceOnly] [-WhatIf] [-Confirm] [] -``` - -### TpmAndStartupKeyProtector - -```PowerShell -Enable-BitLocker [-MountPoint] -TpmAndStartupKeyProtector [-StartupKeyPath] -[-EncryptionMethod ] [-HardwareEncryption] -[-SkipHardwareTest] [-UsedSpaceOnly] [-WhatIf] [-Confirm] [] -``` - -### TpmAndPinAndStartupKeyProtector - -```PowerShell -Enable-BitLocker [-MountPoint] -TpmAndPinAndStartupKeyProtector -StartupKeyPath -[-Pin] [-EncryptionMethod ] -[-HardwareEncryption] [-SkipHardwareTest] [-UsedSpaceOnly] [-WhatIf] [-Confirm] -[] -``` - -### AdAccountOrGroupProtector - -```PowerShell -Enable-BitLocker [-MountPoint] -AdAccountOrGroupProtector [-AdAccountOrGroup] -[-Service] [-EncryptionMethod ] [-HardwareEncryption] -[-SkipHardwareTest] [-UsedSpaceOnly] [-WhatIf] [-Confirm] [] -``` - -### TpmAndPinProtector - -```PowerShell -Enable-BitLocker [-MountPoint] -TpmAndPinProtector [-Pin] -[-EncryptionMethod ] [-HardwareEncryption] -[-SkipHardwareTest] [-UsedSpaceOnly] [-WhatIf] [-Confirm] [] -``` - -### TpmProtector - -```PowerShell -Enable-BitLocker [-MountPoint] -TpmProtector -[-EncryptionMethod ] [-HardwareEncryption] -[-SkipHardwareTest] [-UsedSpaceOnly] [-WhatIf] [-Confirm] [] -``` - -### RecoveryKeyProtector - -```PowerShell -Enable-BitLocker [-MountPoint] -RecoveryKeyProtector [-RecoveryKeyPath] -[-EncryptionMethod ] [-HardwareEncryption] -[-SkipHardwareTest] [-UsedSpaceOnly] [-WhatIf] [-Confirm] [] -``` - -## DESCRIPTION - -The **Enable-BitLocker** cmdlet enables BitLocker Drive Encryption for a volume. - -When you enable encryption, you must specify a volume, either by its drive letter or by its -BitLocker volume object. - -You must also establish a key protector. BitLocker uses a key protector to encrypt the volume -encryption key. When a user accesses a BitLocker encrypted drive, such as when starting a computer, -BitLocker requests the relevant key protector. For example, the user can enter a PIN or provide a -USB drive that contains a key. BitLocker decrypts the encryption key and uses it to read data from -the drive. You can use one of the following methods or combinations of methods for a key protector: - -- **Trusted Platform Module (TPM):** BitLocker uses the computer's TPM to protect the encryption - key. If you select this key protector, users can access the encrypted drive as long as it is - connected to the system board that hosts the TPM and system boot integrity is intact. In general, - TPM-based protectors can only be associated to an operating system volume. - -- **TPM and Personal Identification Number (PIN):** BitLocker uses a combination of the TPM and a - user-supplied PIN. A PIN is four to twenty digits or, if you allow enhanced PINs, is four to - twenty letters, symbols, spaces, or numbers. - -- **TPM, PIN, and startup key:** BitLocker uses a combination of the TPM, a user-supplied PIN, and - input from of a USB memory device that contains an external key. - -- **TPM and startup key:** BitLocker uses a combination of the TPM and a USB flash drive that - contains the external key. - -- **Startup key:** BitLocker uses a USB flash drive that contains the external key. - -- **Password:** BitLocker uses a password. - -- **Recovery key:** BitLocker uses a recovery key stored as a specified file. - -- **Recovery password:** BitLocker uses a recovery password. - -- **Active Directory Domain Services (AD DS) account:** BitLocker uses domain authentication. - -You can specify only one of these methods or combinations when you enable encryption, but you can -use the **Add-BitLockerKeyProtector** cmdlet to add other protectors. - -For a password or PIN key protector, specify a secure string. You can use the -**ConvertTo-SecureString** cmdlet to create a secure string. You can use secure strings in a script -and still maintain confidentiality of passwords. - -You may optionally select an encryption method. By default, BitLocker uses AES-128 but you can opt -AES-256 for stronger security. You may request hardware encryption but we strongly advise -against it. For further guidance, see the -[ADV180028 Security Advisory](https://msrc.microsoft.com/update-guide/vulnerability/ADV180028). - -This cmdlet returns a BitLocker volume object. If you choose recovery password as your key protector -but do not specify a 48-digit recovery password, this cmdlet generates a random one for you, and -stores it in the **RecoveryPassword** field of the **KeyProtector** attribute of the BitLocker -volume object. - -If you use startup key or recovery key as part of your key protector, provide a path to store the -key. This cmdlet stores the name of the file that contains the key in the **KeyFileName** field of -the **KeyProtector** field in the BitLocker volume object. - -If you use the **Enable-BitLocker** cmdlet on an encrypted volume or on a volume with -encryption in process, it takes no action. If you use the cmdlet on a drive that has encryption -paused, it resumes encryption on the volume. - -By default, this cmdlet encrypts the entire drive. If you use the *UsedSpaceOnly* parameter, it only -encrypts the used space on the disk. This option can significantly reduce encryption time. - -It is common practice to add a recovery password for an operating system volume using the -**Add-BitLockerKeyProtector** cmdlet, save the recovery password using the -**Backup-BitLockerKeyProtector** cmdlet, and then enable BitLocker on that volume. This procedure -ensures that you have a recovery option. - -For an overview of BitLocker, see the -[BitLocker Drive Encryption Overview](/previous-versions/windows/it-pro/windows-server-2008-R2-and-2008/cc732774(v=ws.11)). - -## EXAMPLES - -### Example 1: Enable BitLocker - -```PowerShell -$SecureString = ConvertTo-SecureString "1234" -AsPlainText -Force -Enable-BitLocker -MountPoint "C:" -EncryptionMethod Aes256 -UsedSpaceOnly -Pin $SecureString -TPMandPinProtector -``` - -This example enables BitLocker for a specified drive using the TPM and a PIN for key protector. - -The first command uses the **ConvertTo-SecureString** cmdlet to create a secure string that contains a PIN and saves that string in the $SecureString variable. -For more information about the **ConvertTo-SecureString** cmdlet, type `Get-Help ConvertTo-SecureString`. - -The second command enables BitLocker encryption for the BitLocker volume that has the drive letter C:. -The cmdlet specifies an encryption algorithm and the PIN saved in the $SecureString variable. -The command also specifies that this volume uses a combination of the TPM and the PIN as key protector. -The command also specifies to encrypt the used space data on the disk, instead of the entire volume. -When the system writes data to the volume in the future, that data is encrypted. - -### Example 2: Enable BitLocker with a recovery key - -```PowerShell -Get-BitLockerVolume | Enable-BitLocker -EncryptionMethod Aes128 -RecoveryKeyPath "E:\Recovery\" -RecoveryKeyProtector -``` - -This command gets all the BitLocker volumes for the current computer and passes pipes them to the **Enable-BitLocker** cmdlet by using the pipe operator. -This cmdlet specifies an encryption algorithm for the volume or volumes. -This cmdlet specifies a path to a folder where the randomly generated recovery key will be stored and indicates that these volumes use a recovery key as a key protector. - -### Example 3: Enable BitLocker with a specified user account - -```PowerShell -Enable-BitLocker -MountPoint "C:" -EncryptionMethod Aes128 -AdAccountOrGroup "Western\SarahJones" -AdAccountOrGroupProtector -``` - -This command encrypts the BitLocker volume specified by the *MountPoint* parameter, and uses the AES 128 encryption method. -The command also specifies an account and specifies that BitLocker uses user credentials as a key protector. -When a user accesses this volume, BitLocker prompts for credentials for the user account Western\SarahJones. - -## PARAMETERS - -### -AdAccountOrGroup - -Specifies an account using the format Domain\User. -This cmdlet adds the account you specify as a key protector for the volume encryption key. - -```yaml -Type: String -Parameter Sets: AdAccountOrGroupProtector -Aliases: sid - -Required: True -Position: 1 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -AdAccountOrGroupProtector - -Indicates that BitLocker uses an AD DS account as a protector for the volume encryption key. - -```yaml -Type: SwitchParameter -Parameter Sets: AdAccountOrGroupProtector -Aliases: sidp - -Required: True -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -Confirm - -Prompts you for confirmation before running the cmdlet. - -```yaml -Type: SwitchParameter -Parameter Sets: (All) -Aliases: cf - -Required: False -Position: Named -Default value: False -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -EncryptionMethod - -Specifies an encryption method for the encrypted drive. The accepted values are "Aes128", "Aes256", -and "Hardware". The latter has been deprecated and doesn't appear in the next versions of Windows. -We strongly advise not enabling hardware encryption. For further guidance, see the -[ADV180028 Security Advisory](https://msrc.microsoft.com/update-guide/vulnerability/ADV180028). - -```yaml -Type: BitLockerVolumeEncryptionMethodOnEnable -Parameter Sets: (All) -Aliases: -Accepted values: Aes128, Aes256, Hardware - -Required: False -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -HardwareEncryption - -Indicates that the volume uses hardware encryption. We strongly advise against hardware encryption. -For further guidance, see the -[ADV180028 Security Advisory](https://msrc.microsoft.com/update-guide/vulnerability/ADV180028). - -```yaml -Type: SwitchParameter -Parameter Sets: (All) -Aliases: - -Required: False -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -MountPoint - -Specifies an array of drive letters or BitLocker volume objects. -This cmdlet enables protection for the volumes specified. -To obtain a BitLocker volume object, use the **Get-BitLockerVolume** cmdlet. - -```yaml -Type: String[] -Parameter Sets: (All) -Aliases: - -Required: True -Position: 0 -Default value: None -Accept pipeline input: True (ByPropertyName, ByValue) -Accept wildcard characters: False -``` - -### -Password - -Specifies a secure string object that contains a password. -The password specified acts as a protector for the volume encryption key. - -```yaml -Type: SecureString -Parameter Sets: PasswordProtector -Aliases: pw - -Required: False -Position: 1 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -PasswordProtector - -Indicates that BitLocker uses a password as a protector for the volume encryption key. - -```yaml -Type: SwitchParameter -Parameter Sets: PasswordProtector -Aliases: pwp - -Required: True -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -Pin - -Specifies a secure string object that contains a PIN. -BitLocker uses the PIN specified, with other data, as a protector for the volume encryption key. - -```yaml -Type: SecureString -Parameter Sets: TpmAndPinAndStartupKeyProtector, TpmAndPinProtector -Aliases: p - -Required: False -Position: 1 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -RecoveryKeyPath - -Specifies a path to a folder. -This cmdlet adds a randomly generated recovery key as a protector for the volume encryption key and stores it in the specified path. - -```yaml -Type: String -Parameter Sets: RecoveryKeyProtector -Aliases: rk - -Required: True -Position: 1 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -RecoveryKeyProtector - -Indicates that BitLocker uses a recovery key as a protector for the volume encryption key. - -```yaml -Type: SwitchParameter -Parameter Sets: RecoveryKeyProtector -Aliases: rkp - -Required: True -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -RecoveryPassword - -Specifies a recovery password. The cmdlet adds the password specified or created as a protector for the volume encryption key. -If you do not specify this parameter (but specify `-RecoveryPasswordProtector`, the cmdlet creates a random recovery password. - -A recovery password has rigid requirements. It must consist of 48 digits. Each six must be divisible by 11. For example, the -following is acceptable: - - '147279-525107-204677-117612-367510-356554-273911-527274' - -The following is **not** acceptable: - - '702510-071786-013337-543770-555603-414075-635673-114355' - -In the example above, only the second segment is divisible by 11. The others are not. - -```yaml -Type: String -Parameter Sets: RecoveryPasswordProtector -Aliases: rp - -Required: False -Position: 1 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -RecoveryPasswordProtector - -Indicates that BitLocker uses a recovery password as a protector for the volume encryption key. - -```yaml -Type: SwitchParameter -Parameter Sets: RecoveryPasswordProtector -Aliases: rpp - -Required: True -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -Service - -Indicates that the system account for this computer unlocks the encrypted volume. - -```yaml -Type: SwitchParameter -Parameter Sets: AdAccountOrGroupProtector -Aliases: - -Required: False -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -SkipHardwareTest - -Indicates that BitLocker does not perform a hardware test before it begins encryption. -BitLocker uses a hardware test as a dry run to make sure that all the key protectors are correctly set up and that the computer can start without issues. - -```yaml -Type: SwitchParameter -Parameter Sets: (All) -Aliases: s - -Required: False -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -StartupKeyPath - -Specifies a path to a startup key. -The key stored in the specified path acts as a protector for the volume encryption key. - -```yaml -Type: String -Parameter Sets: StartupKeyProtector, TpmAndStartupKeyProtector, TpmAndPinAndStartupKeyProtector -Aliases: sk - -Required: True -Position: 1 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -StartupKeyProtector - -Indicates that BitLocker uses a startup key as a protector for the volume encryption key. - -```yaml -Type: SwitchParameter -Parameter Sets: StartupKeyProtector -Aliases: skp - -Required: True -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -TpmAndPinAndStartupKeyProtector - -Indicates that BitLocker uses a combination of the TPM, a PIN, and a startup key as a protector for the volume encryption key. - -```yaml -Type: SwitchParameter -Parameter Sets: TpmAndPinAndStartupKeyProtector -Aliases: tpskp - -Required: True -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -TpmAndPinProtector - -Indicates that BitLocker uses a combination of the TPM and a PIN as a protector for the volume encryption key. - -```yaml -Type: SwitchParameter -Parameter Sets: TpmAndPinProtector -Aliases: tpp - -Required: True -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -TpmAndStartupKeyProtector - -Indicates that BitLocker uses a combination of the TPM and a startup key as a protector for the volume encryption key. - -```yaml -Type: SwitchParameter -Parameter Sets: TpmAndStartupKeyProtector -Aliases: tskp - -Required: True -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -TpmProtector - -Indicates that BitLocker uses the TPM as a protector for the volume encryption key. - -```yaml -Type: SwitchParameter -Parameter Sets: TpmProtector -Aliases: tpmp - -Required: True -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -UsedSpaceOnly - -Indicates that BitLocker does not encrypt unallocated disk space. - -```yaml -Type: SwitchParameter -Parameter Sets: (All) -Aliases: qe - -Required: False -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -WhatIf - -Shows what would happen if the cmdlet runs. -The cmdlet is not run. - -```yaml -Type: SwitchParameter -Parameter Sets: (All) -Aliases: wi - -Required: False -Position: Named -Default value: False -Accept pipeline input: False -Accept wildcard characters: False -``` - -### CommonParameters - -This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). - -## INPUTS - -### BitLockerVolume[], String[] - -## OUTPUTS - -### BitLockerVolume[] - -## NOTES - -## RELATED LINKS - -[Disable-BitLocker](./Disable-BitLocker.md) - -[Get-BitLockerVolume](./Get-BitLockerVolume.md) - -[Lock-BitLocker](./Lock-BitLocker.md) - -[Resume-BitLocker](./Resume-BitLocker.md) - -[Suspend-BitLocker](./Suspend-BitLocker.md) - -[Unlock-BitLocker](./Unlock-BitLocker.md) From f26ca293aa49ee425ff798bc70275d4e71d370c0 Mon Sep 17 00:00:00 2001 From: skycommand <17097175+skycommand@users.noreply.github.com> Date: Sun, 22 Nov 2026 05:48:35 +0330 Subject: [PATCH 13/13] Update Enable-BitLocker.md Fixed the conflict resolution fiasco --- .../winserver2025-ps/BitLocker/Enable-BitLocker.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/docset/winserver2025-ps/BitLocker/Enable-BitLocker.md b/docset/winserver2025-ps/BitLocker/Enable-BitLocker.md index b03b8983a1..89f04dbb0b 100644 --- a/docset/winserver2025-ps/BitLocker/Enable-BitLocker.md +++ b/docset/winserver2025-ps/BitLocker/Enable-BitLocker.md @@ -3,7 +3,7 @@ description: Use this topic to help manage Windows and Windows Server technologi external help file: BitLocker-help.xml Module Name: BitLocker ms.date: 12/14/2021 -online version: https://learn.microsoft.com/powershell/module/bitlocker/enable-bitlocker?view=windowsserver2012-ps&wt.mc_id=ps-gethelp +online version: https://learn.microsoft.com/powershell/module/bitlocker/enable-bitlocker?view=windowsserver2025-ps&wt.mc_id=ps-gethelp schema: 2.0.0 title: Enable-BitLocker --- @@ -134,9 +134,11 @@ For a password or PIN key protector, specify a secure string. You can use the **ConvertTo-SecureString** cmdlet to create a secure string. You can use secure strings in a script and still maintain confidentiality of passwords. -You may optionally select an encryption method. By default, BitLocker uses AES-128 but you can opt -AES-256 for stronger security. (Diffuser is not supported.) You may request hardware encryption but -we strongly advise against it. For further guidance, see the +We strongly recommend specifying the encryption method. By default, BitLocker uses XTS-AES-128. You +can opt XTS-AES-256 for stronger security. However, if you are encrypting a removable media and +intend to use it on Windows 8.1 or Windows Server 2012 R2, you must opt either AES-128 or AES-256 +for backward compatibility. You may request hardware encryption but we strongly advise +against it. For further guidance, see the [ADV180028 Security Advisory](https://msrc.microsoft.com/update-guide/vulnerability/ADV180028). This cmdlet returns a BitLocker volume object. If you choose recovery password as your key protector @@ -265,7 +267,7 @@ We strongly advise not enabling hardware encryption. For further guidance, see t Type: BitLockerVolumeEncryptionMethodOnEnable Parameter Sets: (All) Aliases: -Accepted values: Aes128, Aes256, Hardware +Accepted values: Aes128, Aes256, XtsAes128, XtsAes256 Required: False Position: Named