PowerShell Commands

Confirm-SecureBootUEFI

Confirm-SecureBootUEFI [<CommonParameters>]

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 PowerShellr 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: Verbose, Debug,ErrorAction, ErrorVariable, WarningAction, WarningVariable,OutBuffer, PipelineVariable, and OutVariable.

Inputs
None
Outputs
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
  1. Confirm Secure Boot:
    PS C:\>  Confirm-SecureBootUEFI
    True
    

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

This work is licensed under a Creative Commons Attribution 4.0 International. It is attributed to Microsoft Corporation and can be found here.

PowerShell Commands