Edit

Confirm-SecureBootUEFI

  • Reference
Module:
SecureBoot

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

Boolean

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.