Get-AuthenticodeSignature

  • Referens
Modul:
Microsoft.PowerShell.Security

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

Den här cmdleten är endast tillgänglig på Windows-plattformen.

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 katalogen $PSHOME 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 katalogen $PSHOME. Den använder ett mönster av . att undanta kataloger (även om det även exkluderar filer utan en punkt i filnamnet).

Kommandot använder en pipelineoperator (|) för att skicka filerna i $PSHOME till cmdleten ForEach-Object, där Get-AuthenticodeSignature anropas för varje fil.

Resultatet av kommandot Get-AuthenticodeSignature 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 FilePathanvä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 Content 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

String

Du kan skicka en sträng som innehåller en filsökväg till Get-AuthenticodeSignature.

Utdata

Signature

Get-AuthenticodeSignature returnerar ett signaturobjekt för varje signatur som den får.

Kommentarer

Den här cmdleten är endast tillgänglig på Windows-plattformar.

Information om Authenticode-signaturer i PowerShell finns i about_Signing.