Confirm-SecureBootUEFI

NAME Confirm-SecureBootUEFI



SYNOPSIS

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





SYNTAX

Confirm-SecureBootUEFI [<CommonParameters>]





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: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



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.





Example 1: Confirm Secure Boot



PS C:\\> Confirm-SecureBootUEFI

True



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







RELATED LINKS

Format-SecureBootUEFI

Get-SecureBootPolicy

Get-SecureBootUEFI

Set-SecureBootUEFI