Confirm-SecureBootUEFI

Confirm-SecureBootUEFI

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, 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.

Parameters

<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.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • None

Outputs

The output type is the type of the objects that the cmdlet emits.

  • System.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.


Examples

Example 1: Confirm Secure Boot

This command checks whether Secure Boot is enabled on the computer.


PS C:\> Confirm-SecureBootUEFI

Related topics

Community Additions

ADD
Show: