Confirm-SecureBootUEFI
Confirms that Secure Boot is enabled by checking the Secure Boot status on the local computer.
Syntax
Confirm-SecureBootUEFI []
Description
The Confirm-SecureBootUEFI cmdlet confirms that Secure Boot is enabled by checking the Secure Boot status on a UEFI computer.
If the computer supports Secure Boot and Secure Boot is enabled, this cmdlet returns $True.
If the computer supports Secure Boot and Secure Boot is disabled, this cmdlet returns $False.
If the computer does not support Secure Boot or is a BIOS (non-UEFI) computer, this cmdlet displays the following:
Cmdlet not supported on this platform.
If Windows PowerShell® is not run in administrator mode, this cmdlet displays the following:
Unable to set proper privileges. Access was denied.
This cmdlet requires that Windows PowerShell be run in administrator mode.
Examples
Example 1: Confirm Secure Boot
PS C:\> Confirm-SecureBootUEFI
True
This command checks whether Secure Boot is enabled on the computer.
Inputs
None
Outputs
This cmdlet returns a Boolean. If the computer supports Secure Boot and Secure Boot is enabled, this cmdlet returns $True.
If the computer supports Secure Boot and Secure Boot is disabled, this cmdlet returns $False.
If the computer does not support Secure Boot or is a BIOS (non-UEFI) computer, this cmdlet displays the following:
Cmdlet not supported on this platform
.