Delen via

Get-AuthenticodeSignature

  • Referentie
Module:
Microsoft.PowerShell.Security

Hiermee wordt informatie opgehaald over de Authenticode-handtekening voor een bestand.

Syntaxis

Get-AuthenticodeSignature
   [-FilePath] <String[]>
   [<CommonParameters>]
Get-AuthenticodeSignature
   -LiteralPath <String[]>
   [<CommonParameters>]

Description

De cmdlet Get-AuthenticodeSignature haalt informatie op over de Authenticode-handtekening voor een bestand. Als het bestand niet is ondertekend, wordt de informatie opgehaald, maar zijn de velden leeg.

Voorbeelden

Voorbeeld 1: De Authenticode-handtekening voor een bestand ophalen

Get-AuthenticodeSignature -FilePath "C:\Test\NewScript.ps1"

Met deze opdracht wordt informatie opgehaald over de Authenticode-handtekening in het NewScript.ps1-bestand. Hierbij wordt de parameter FilePath gebruikt om het bestand op te geven.

Voorbeeld 2: De Authenticode-handtekening voor meerdere bestanden ophalen

Get-AuthenticodeSignature test.ps1, test1.ps1, sign-file.ps1, makexml.ps1

Met deze opdracht krijgt u informatie over de Authenticode-handtekening voor de vier bestanden die op de opdrachtregel worden vermeld. In dit voorbeeld wordt de naam van de parameter FilePath, optioneel, weggelaten.

Voorbeeld 3: Alleen geldige Authenticode-handtekeningen voor meerdere bestanden ophalen

Get-ChildItem $PSHOME\*.* | ForEach-object {Get-AuthenticodeSignature $_} | Where-Object {$_.status -eq "Valid"}

Met deze opdracht worden alle bestanden in de $PSHOME map met een geldige Authenticode-handtekening weergegeven. De $PSHOME automatische variabele bevat het pad naar de Installatiemap van PowerShell.

De opdracht maakt gebruik van de cmdlet Get-ChildItem om de bestanden op te halen in de $PSHOME map. Het maakt gebruik van een patroon van . om mappen uit te sluiten (hoewel het ook bestanden zonder punt in de bestandsnaam uitsluit).

De opdracht maakt gebruik van een pijplijnoperator (|) om de bestanden in $PSHOME te verzenden naar de cmdlet ForEach-Object, waarbij Get-AuthenticodeSignature- voor elk bestand wordt aangeroepen.

De resultaten van de opdracht Get-AuthenticodeSignature worden verzonden naar een Where-Object opdracht waarmee alleen de handtekeningobjecten met de status Geldig worden geselecteerd.

Parameters

-FilePath

Hiermee geeft u het pad naar het bestand dat moet worden onderzocht. Jokertekens zijn toegestaan, maar ze moeten leiden tot één bestand. Het is niet nodig om -FilePath op de opdrachtregel te typen wanneer u een waarde voor deze parameter opgeeft.

Type:String[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

-LiteralPath

Hiermee geeft u het pad naar het bestand dat wordt onderzocht. In tegenstelling tot FilePath, wordt de waarde van de parameter LiteralPath exact gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad een escapeteken bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens geven PowerShell aan dat er geen tekens als escapetekens moeten worden geïnterpreteerd.

Type:String[]
Aliassen:PSPath
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

String

U kunt een tekenreeks met een bestandspad doorsluisen naar Get-AuthenticodeSignature.

Uitvoerwaarden

Signature

Get-AuthenticodeSignature retourneert een handtekeningobject voor elke handtekening die wordt opgehaald.

Notities

Zie about_Signingvoor meer informatie over Authenticode-handtekeningen in PowerShell.