Export (0) Print
Expand All
0 out of 1 rated this helpful - Rate this topic

Confirm-SecureBootUEFI

Windows Server 2012 R2 and Windows 8.1

Updated: October 17, 2013

Applies To: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

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

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. 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

    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.


Examples

EXAMPLE 1

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


PS C:\> Confirm-SecureBootUEFI
True

Related topics

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.