Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

Confirm-SecureBootUEFI

Confirm-SecureBootUEFI

microsoft.secureboot.commands.dll

Synopsis

Confirms that Secure Boot is enabled by checking the Secure Boot status on the local computer.

Syntax

Confirm-SecureBootUEFI [<CommonParameters>]

Detailed 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, then this cmdlet returns True.

If the computer supports Secure Boot and Secure Boot is disabled, then this cmdlet returns False.

If the computer does not support Secure Boot or is a BIOS (non-UEFI) computer, then this cmdlet returns an error displaying the following: Cmdlet not supported on this platform.

If Windows PowerShell® is not run in administrator mode, then this cmdlet returns an error displaying the following: Unable to set proper privileges. Access was denied.

This cmdlet requires that Windows PowerShell be run in administrator mode.

Parameters

Input Type

None

Return Type

System.Boolean

Notes

None

Examples

EXAMPLE 1

This example checks whether or not Secure Boot is enabled on the computer.

PS C:\> Confirm-SecureBootUEFI
True

Online Version
Format-SecureBootUEFI
Get-SecureBootPolicy
Get-SecureBootUEFI
Set-SecureBootUEFI