Get-SecureBootUEFI

Get-SecureBootUEFI

Gets the UEFI variable values related to Secure Boot such as the SetupMode, SecureBoot, KEK, PK, SignatureDatabase, and forbidden SignatureDatabase.

Sintaxis

Parameter Set: __AllParameterSets
Get-SecureBootUEFI [-Name] <String> [-OutputFilePath <String> ] [ <CommonParameters>]

Descripción detallada

The Get-SecureBootUEFI cmdlet gets the UEFI variable values related to Secure Boot which are: SetupMode, SecureBoot, KEK, PK, SignatureDatabase (DB), and forbidden SignatureDatabase (DBX).

If the computer does not support Secure Boot or is a BIOS (non-UEFI) computer, then this cmdlet will return an error displaying the following: Cmdlet not supported on this platform.

If the variable does not exist, then this cmdlet will return an error displaying the following: Variable is currently undefined.

If Windows PowerShell® is not run in administrator mode, then this cmdlet will return an error displaying the following: Unable to set proper privileges. Access was denied.

Parámetros

-Name<String>

Specifies the name of the UEFI environment variable.

Alias

ninguno

¿Requerido?

true

¿Posición?

2

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByValue)

¿Aceptar caracteres comodín?

false

-OutputFilePath<String>

Specifies the output file path of the UEFI environment variable.

Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

<CommonParameters>

Este cmdlet admite los siguientes parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet.

  • System.String

    The String object represents the UEFI variable name.

Salidas

El tipo de resultado es el tipo de objetos que emite el cmdlet.

  • Microsoft.SecureBoot.Commands.UEFIEnvironmentVariable

    The UEFIEnvironmentVariable object contains the following properties:
    -- Name
    -- Bytes
    -- Attributes

Ejemplos

EXAMPLE 1

This example gets information about PK from the UEFI variable.

PS C:\> Get-SecureBootUefi –Name PK | Format-List

Temas relacionados

Confirm-SecureBootUEFI

Format-SecureBootUEFI

Get-SecureBootPolicy

Set-SecureBootUEFI