Get-AuthenticodeSignature
Hämtar information om Authenticode-signaturen för en fil.
Syntax
Get-AuthenticodeSignature
[-FilePath] <String[]>
[<CommonParameters>]
Get-AuthenticodeSignature
-LiteralPath <String[]>
[<CommonParameters>]
Get-AuthenticodeSignature
-SourcePathOrExtension <String[]>
-Content <Byte[]>
[<CommonParameters>]
Description
Cmdleten Get-AuthenticodeSignature
hämtar information om Authenticode-signaturen för en fil eller filinnehåll som en bytematris.
Om filen är både inbäddad signerad och Windows-katalogsignerad används Windows-katalogsignaturen.
Om filen inte är signerad hämtas informationen, men fälten är tomma.
Exempel
Exempel 1: Hämta Authenticode-signaturen för en fil
Get-AuthenticodeSignature -FilePath "C:\Test\NewScript.ps1"
Det här kommandot hämtar information om Authenticode-signaturen i filen NewScript.ps1. Den använder Parametern FilePath för att ange filen.
Exempel 2: Hämta Authenticode-signaturen för flera filer
Get-AuthenticodeSignature test.ps1, test1.ps1, sign-file.ps1, makexml.ps1
Det här kommandot hämtar information om Authenticode-signaturen för de fyra filer som visas på kommandoraden. I det här exemplet utelämnas namnet på parametern FilePath , som är valfri.
Exempel 3: Hämta endast giltiga Authenticode-signaturer för flera filer
Get-ChildItem $PSHOME\*.* | ForEach-object {Get-AuthenticodeSignature $_} | Where-Object {$_.status -eq "Valid"}
Det här kommandot visar alla filer i $PSHOME
katalogen som har en giltig Authenticode-signatur. Den $PSHOME
automatiska variabeln innehåller sökvägen till PowerShell-installationskatalogen.
Kommandot använder cmdleten Get-ChildItem
för att hämta filerna i $PSHOME
katalogen. Det använder ett mönster med . för att exkludera kataloger (även om det även exkluderar filer utan en punkt i filnamnet).
Kommandot använder en pipelineoperator (|
) för att skicka in filerna $PSHOME
till cmdleten ForEach-Object
, där Get-AuthenticodeSignature
anropas för varje fil.
Resultatet av Get-AuthenticodeSignature
kommandot skickas till ett Where-Object
kommando som endast väljer signaturobjekten med statusen Giltig.
Exempel 4: Hämta Authenticode-signaturen för ett filinnehåll som anges som bytematris
Get-AuthenticodeSignature -Content (Get-Content foo.ps1 -AsByteStream) -SourcePathorExtension ps1
Det här kommandot hämtar information om Authenticode-signaturen för innehållet i en fil. I det här exemplet anges filnamnstillägget tillsammans med innehållet i filen.
Parametrar
-Content
Innehållet i en fil som en bytematris som Authenticode-signaturen hämtas för. Den här parametern måste användas med parametern SourcePathOrExtension . Innehållet i filen måste vara i Unicode-format (UTF-16LE).
Typ: | Byte[] |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-FilePath
Anger sökvägen till filen som ska undersökas. Jokertecken tillåts, men de måste leda till en enda fil. Du behöver inte skriva FilePath på kommandoraden när du anger ett värde för den här parametern.
Typ: | String[] |
Position: | 0 |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | True |
-LiteralPath
Anger sökvägen till filen som undersöks. Till skillnad från FilePath används värdet för parametern LiteralPath precis som det skrivs. Inga tecken tolkas som jokertecken. Om sökvägen innehåller ett escape-tecken omger du det inom enkla citattecken. Enkla citattecken gör att PowerShell inte tolkar några tecken som escape-tecken.
Typ: | String[] |
Alias: | PSPath |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-SourcePathOrExtension
Sökväg till filen eller filtypen för innehållet som Authenticode-signaturen hämtas för. Den här parametern används med Innehåll där filinnehåll skickas som en bytematris.
Typ: | String[] |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
Indata
Du kan skicka en sträng som innehåller en filsökväg till den här cmdleten.
Utdata
Den här cmdleten returnerar ett signaturobjekt för varje signatur som den får.
Kommentarer
Information om Authenticode-signaturer i PowerShell finns i about_Signing.