Get-AuthenticodeSignature

Artikel
10/30/2009

Ruft Informationen über die Authenticode-Signatur in einer Datei ab.

Syntax

Get-AuthenticodeSignature [-FilePath] <string[]> [<CommonParameters>]

Beschreibung

Das Cmdlet "Get-AuthenticodeSignature" ruft Informationen über die Authenticode-Signatur in einer Datei ab. Wenn die Datei nicht signiert ist, werden die Informationen abgerufen, die Felder bleiben jedoch leer.

Parameter

-FilePath <string[]>

Gibt den Pfad zur untersuchten Datei an. Platzhalter sind zulässig, müssen jedoch zu einer einzelnen Datei führen. Der Parametername ("FilePath") ist optional.

Erforderlich?	true
Position?	1
Standardwert
Pipelineeingaben akzeptieren?	true (ByValue, ByPropertyName)
Platzhalterzeichen akzeptieren?	false

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Eingaben und Ausgaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.

Eingaben

System.String

Sie können eine Zeichenfolge mit einem Dateipfad über die Pipeline an Get-AuthenticodeSignature übergeben.

Ausgaben

System.Management.Automation.Signature

Get-AuthenticodeSignature gibt ein Signaturobjekt für jede Signatur zurück, die es abruft.

Hinweise

Weitere Informationen über Authenticode-Signaturen in Windows PowerShell finden Sie unter "about_Signing".

Beispiel 1

C:\PS>get-AuthenticodeSignature -filepath C:\Test\NewScript.ps1

Beschreibung
-----------
Mit diesem Befehl werden Informationen über die Authenticode-Signatur in der Datei "NewScript.ps1" abgerufen. Mit dem FilePath-Parameter wird die Datei angegeben.

Beispiel 2

C:\PS>get-authenticodesignature test.ps1, test1.ps1, sign-file.ps1, makexml.ps1

Beschreibung
-----------
Mit diesem Befehl werden Informationen über die Authenticode-Signatur in den vier in der Befehlszeile aufgeführten Dateien abgerufen. Der Name des FilePath-Parameters ist optional und in diesem Befehl nicht enthalten.

Beispiel 3

C:\PS>get-childitem $pshome\*.* | foreach-object {Get-AuthenticodeSignature $_} | where {$_.status -eq "Valid"}

Beschreibung
-----------
Von diesem Befehl werden alle Dateien im Verzeichnis "$pshome" aufgelistet, die über eine gültige Authenticode-Signatur verfügen. Die automatische Variable "$pshome" enthält den Pfad zum Windows PowerShell-Installationsverzeichnis.

Im Befehl werden mit dem Cmdlet "Get-ChildItem" die Dateien im Verzeichnis "$pshome" abgerufen. Mit dem Muster "* *" werden Verzeichnisse ausgeschlossen (es werden jedoch auch Dateien ohne Punkt im Dateinamen ausgeschlossen).

Vom Befehl werden die Dateien in "$pshome" mit einem Pipelineoperator (|) an das Cmdlet "Foreach-Object" gesendet, wobei Get-AuthenticodeSignature für jede Datei aufgerufen wird. 

Die Ergebnisse des Befehls "Get-AuthenticodeSignature" werden an den Befehl "Where-Object" gesendet, von dem nur die Signaturobjekte mit dem Status "Valid" ausgewählt werden.

Siehe auch

Konzepte

about_Signing
about_Execution_Policies
Set-AuthenticodeSignature
Get-ExecutionPolicy
Set-ExecutionPolicy

Freigeben über