Get-AuthenticodeSignature
Gets information about the Authenticode signature for a file.
구문
ByPath (기본값)
Get-AuthenticodeSignature
[-FilePath] <String[]>
[<CommonParameters>]
ByLiteralPath
Get-AuthenticodeSignature
-LiteralPath <String[]>
[<CommonParameters>]
ByContent
Get-AuthenticodeSignature
-SourcePathOrExtension <String[]>
-Content <Byte[]>
[<CommonParameters>]
Description
The Get-AuthenticodeSignature
cmdlet gets information about the Authenticode signature for a
file or file content as a byte array.
If the file is both embedded signed and Windows catalog signed,
the Windows catalog signature is used.
If the file is not signed, the information is retrieved, but
the fields are blank.
예제
Example 1: Get the Authenticode signature for a file
Get-AuthenticodeSignature -FilePath "C:\Test\NewScript.ps1"
This command gets information about the Authenticode signature in the NewScript.ps1 file. It uses the FilePath parameter to specify the file.
Example 2: Get the Authenticode signature for multiple files
Get-AuthenticodeSignature test.ps1, test1.ps1, sign-file.ps1, makexml.ps1
This command gets information about the Authenticode signature for the four files listed at the command line. In this example, the name of the FilePath parameter, which is optional, is omitted.
Example 3: Get only valid Authenticode signatures for multiple files
Get-ChildItem $PSHOME\*.* |
ForEach-Object {Get-AuthenticodeSignature $_} |
Where-Object {$_.Status -eq "Valid"}
This command lists all of the files in the $PSHOME
directory that have a valid Authenticode
signature. The $PSHOME
automatic variable contains the path to the PowerShell installation
directory.
The command uses the Get-ChildItem
cmdlet to get the files in the $PSHOME
directory. It uses a
pattern of . to exclude directories (although it also excludes files without a dot in the
filename).
The command uses a pipeline operator (|
) to send the files in $PSHOME
to the ForEach-Object
cmdlet, where Get-AuthenticodeSignature
is called for each file.
The results of the Get-AuthenticodeSignature
command are sent to a Where-Object
command that
selects only the signature objects with a status of Valid.
Example 4: Get the Authenticode signature for a file content specified as byte array
Get-AuthenticodeSignature -Content (Get-Content foo.ps1 -AsByteStream) -SourcePathorExtension ps1
This command gets information about the Authenticode signature for the content of a file. In this example, the file extension is specified along with the content of the file.
매개 변수
-Content
Contents of a file as a byte array for which the Authenticode signature is retrieved. This parameter must be used with SourcePathOrExtension parameter. The contents of the file must be in Unicode (UTF-16LE) format.
매개 변수 속성
형식: | Byte[] |
Default value: | None |
와일드카드 지원: | False |
DontShow: | False |
매개 변수 집합
ByContent
Position: | Named |
필수: | True |
파이프라인의 값: | False |
속성 이름별 파이프라인의 값: | True |
나머지 인수의 값: | False |
-FilePath
Specifies the path to the file to examine. Wildcards are permitted, but they must lead to a single file. It is not necessary to type FilePath at the command line when you specify a value for this parameter.
매개 변수 속성
형식: | String[] |
Default value: | None |
와일드카드 지원: | True |
DontShow: | False |
매개 변수 집합
ByPath
Position: | 0 |
필수: | True |
파이프라인의 값: | True |
속성 이름별 파이프라인의 값: | True |
나머지 인수의 값: | False |
-LiteralPath
Specifies the path to the file being examined. Unlike FilePath, the value of the LiteralPath parameter is used exactly as it is typed. No characters are interpreted as wildcards. If the path includes an escape character, enclose it in single quotation marks. Single quotation marks tell PowerShell not to interpret any characters as escape characters.
매개 변수 속성
형식: | String[] |
Default value: | None |
와일드카드 지원: | False |
DontShow: | False |
별칭: | PSPath |
매개 변수 집합
ByLiteralPath
Position: | Named |
필수: | True |
파이프라인의 값: | False |
속성 이름별 파이프라인의 값: | True |
나머지 인수의 값: | False |
-SourcePathOrExtension
Path to the file or file type of the content for which the Authenticode signature is retrieved. This parameter is used with Content where file content is passed as a byte array.
매개 변수 속성
형식: | String[] |
Default value: | None |
와일드카드 지원: | False |
DontShow: | False |
매개 변수 집합
ByContent
Position: | Named |
필수: | True |
파이프라인의 값: | True |
속성 이름별 파이프라인의 값: | True |
나머지 인수의 값: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
입력
String
You can pipe a string that contains a file path to this cmdlet.
출력
Signature
This cmdlet returns a signature object for each signature that it gets.
참고
For information about Authenticode signatures in PowerShell, see about_Signing.