Table of contents
TLS
TOC
Collapse the table of content
Expand the table of content

Confirm-SecureBootUEFI

Brian Lich|Last Updated: 4/3/2017

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.

EXAMPLES

Example 1: Confirm Secure Boot

PS C:\> Confirm-SecureBootUEFI
True

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

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

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.

NOTES

Format-SecureBootUEFI

Get-SecureBootPolicy

Get-SecureBootUEFI

Set-SecureBootUEFI

© 2017 Microsoft