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 $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).

Type:Byte[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Indata

String

Du kan skicka en sträng som innehåller en filsökväg till den här cmdleten.

Utdata

Signature

Den här cmdleten 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.