Format-SecureBootUEFI

Windows Server 2012 R2 and Windows 8.1

Format-SecureBootUEFI

Formats certificates or hashes into a content object that is returned and creates a file that is ready to be signed.

구문

Parameter Set: __AllParameterSets
Format-SecureBootUEFI -Name <String> [-SignableFilePath <String> ] [-Time <String> ] [ <CommonParameters>]

Parameter Set: FormatForCertificates
Format-SecureBootUEFI -CertificateFilePath <String[]> -SignatureOwner <Guid> [-AppendWrite] [-ContentFilePath <String> ] [-FormatWithCert] [ <CommonParameters>]

Parameter Set: FormatForDelete
Format-SecureBootUEFI -Delete [ <CommonParameters>]

Parameter Set: FormatForHashes
Format-SecureBootUEFI -Algorithm <String> -Hash <String[]> -SignatureOwner <Guid> [-AppendWrite] [-ContentFilePath <String> ] [ <CommonParameters>]




자세한 설명

The Format-SecureBootUEFI cmdlet receives certificates or hashes as input and formats the input into a content object that is returned. This returned object will be used by the Set-SecureBootUEFI cmdlet for actually updating the variable. If a signable file is specified, then this cmdlet creates a file with the specified name that needs to be signed.

This cmdlet will run on both UEFI and BIOS (non-UEFI) computers.

매개 변수

-Algorithm<String>

Specifies, if this cmdlet is formatting hashes, which algorithm is being used. 이 매개 변수에 허용되는 값은 다음과 같습니다. SHA1, SHA256, SHA384, or SHA512.


별칭

없음

필수 여부

true

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-AppendWrite

Indicates that the contents of the current variable is appended instead of overwritten.


별칭

없음

필수 여부

false

위치

named

기본값

false

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-CertificateFilePath<String[]>

Specifies a list of one or more files each containing a certificate that is used to generate the content object.
If only the name is specified, then the file must be in the current working directory; otherwise the full path of the file must be specified.


별칭

없음

필수 여부

true

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-ContentFilePath<String>

Specifies the name of the file that is created and contains the information for the content object that is generated by this cmdlet.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-Delete

Indicates that the content object, as well as the appropriate sign-able file, is created that deletes the variable.


별칭

없음

필수 여부

true

위치

named

기본값

False

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-FormatWithCert

Indicates whether the certificate will be stored or just the public key. If this parameter is set, then the entire certificate is stored in the content object.


별칭

없음

필수 여부

false

위치

named

기본값

false

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-Hash<String[]>

Specifies a list of hashes that are used to generate the content.


별칭

없음

필수 여부

true

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-Name<String>

Specifies the name of the UEFI environment variable. 이 매개 변수에 허용되는 값은 다음과 같습니다. PK, KEK, DB, or DBX.


별칭

없음

필수 여부

true

위치

named

기본값

없음

파이프라인 입력 적용 여부

True (ByValue)

와일드카드 문자 허용 여부

false

-SignableFilePath<String>

Specifies the file that contains the contents of the data that is ready to be signed.
If only the name is specified, then the file must be in the current working directory; otherwise the full path of the file must be specified.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-SignatureOwner<Guid>

Specifies the GUID of the signature owner.


별칭

없음

필수 여부

true

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-Time<String>

Specifies the timestamp that is used in the signature. This parameter value should be formatted as follows so that it will be accepted by the DateTime object. "2011-11-01T13:30:00Z"


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

<CommonParameters>

이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 다음을 참조하세요. about_CommonParameters(http://go.microsoft.com/fwlink/p/?LinkID=113216).

입력

입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다.

  • System.String

    The String object represents the UEFI variable name that may be output from the Get-SecureBootUEFI cmdlet.


출력

출력 유형은 cmdlet이 내보내는 개체의 유형입니다.

  • Microsoft.SecureBoot.Commands.UEFIFormattedVariable

    The UEFIFormattedVariable object contains information about the package that is built up to be set. The following members are part of the UEFIFormattedVariable object.
    -- A string named Name.
    -- A string named Time.
    -- A boolean named AppendWrite.
    -- An array of bytes named Content.
    The UEFIFormattedVariable object can be used to pipe into the Set-SecureBootUEFIcmdlet.


예제

EXAMPLE 1

This example formats the private key in PK.cer being piped into the Set-SecureBootUEFI cmdlet.


PS C:\> Format-SecureBootUefi -Name PK -SignatureOwner 12345678-1234-1234-1234-123456789abc -CertificateFilePath PK.cer -SignableFilePath GeneratedFileToSign.bin -Time 2011-11-01T13:30:00Z | Format-List

EXAMPLE 2

This example formats the hash being appended to the DBX UEFI variable when piped into the Set-SecureBootUEFI cmdlet.


PS C:\> Format-SecureBootUEFI -Name DBX -SignatureOwner 12345678-1234-1234-1234-123456789abc -Algorithm SHA256 -Hash 0011223344556677889900112233445566778899001122334455667788990011 -SignableFilePath GeneratedFileToSign.bin -Time 2011-11-01T13:30:00Z -AppendWrite | Format-List

EXAMPLE 3

This example formats the KEK UEFI variable being deleted when piped into the Set-SecureBootUEFI cmdlet.


PS C:\> Format-SecureBootUEFI -Name KEK -Delete -SignableFilePath GeneratedFileToSign.bin -Time 2011-11-01T13:30:00Z | Format-List

관련 항목

커뮤니티 추가 항목

추가
표시: