Megosztás a következőn keresztül:

Get-AuthenticodeSignature

Modul:
Microsoft.PowerShell.Security Module

A fájl Authenticode-aláírásával kapcsolatos információk lekérdezése.

Syntax

ByPath (Alapértelmezett) 

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

ByLiteralPath 

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

ByContent 

Get-AuthenticodeSignature
    -SourcePathOrExtension <String[]>
    -Content <Byte[]>
    [<CommonParameters>]

Description

Ez a parancsmag csak a Windows platformon érhető el.

A Get-AuthenticodeSignature parancsmag információhoz jut egy fájl vagy fájltartalom authenticode aláírásáról bájttömbként. Ha a fájl mind beágyazott aláírással, mind Windows-katalógus aláírással rendelkezik, a Windows-katalógus aláírás kerül felhasználásra. Ha a fájl nincs aláírva, a rendszer lekéri az adatokat, de a mezők üresek.

Példák

1. példa: Fájl authenticode aláírásának lekérése

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

Ez a parancs információt kap az Authenticode aláírásról a NewScript.ps1 fájlban. A fájl megadásához a FilePath paramétert használja.

2. példa: Az Authenticode aláírás lekérése több fájlhoz

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

Ez a parancs a parancssorban felsorolt négy fájl authenticode-aláírásával kapcsolatos információkat kap. Ebben a példában a FilePath paraméter neve hiányzik, amely nem kötelező.

3. példa: Csak érvényes Authenticode-aláírások lekérése több fájlhoz

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

Ez a parancs felsorolja a $PSHOME könyvtárban lévő összes olyan fájlt, amely érvényes Authenticode-aláírással rendelkezik. Az $PSHOME automatikus változó tartalmazza a PowerShell telepítési könyvtárának elérési útját.

A parancs a Get-ChildItem parancsmaggal szerzi be a fájlokat a $PSHOME könyvtárba. A mintát használja a könyvtárak kizárására (bár a fájlnevekben pont nélküli fájlokat is kizár).

A parancs egy folyamatkezelő (|) használatával küldi el a $PSHOME fájlokat a ForEach-Object parancsmagba, ahol az egyes fájlokhoz Get-AuthenticodeSignature kell meghívni.

A Get-AuthenticodeSignature parancs eredményeit egy Where-Object parancs küldi el, amely csak az érvényes állapotú aláírási objektumokat választja ki.

4. példa: A bájttömbként megadott fájltartalom authenticode aláírásának lekérése

Get-AuthenticodeSignature -Content (Get-Content foo.ps1 -AsByteStream) -SourcePathorExtension ps1

Ez a parancs információt kér le a fájl tartalmához tartozó Authenticode aláírásról. Ebben a példában a fájlkiterjesztés a fájl tartalmával együtt van megadva.

Paraméterek

-Content

Egy fájl tartalma bájttömbként, amelyhez lekéri az Authenticode-aláírást. Ezt a paramétert SourcePathOrExtension paraméterrel kell használni. A fájl tartalmának Unicode (UTF-16LE) formátumban kell lennie.

Paramétertulajdonságok

Típus:

Byte[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ByContent
Position:Named
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-FilePath

Megadja a vizsgálandó fájl elérési útját. A helyettesítő karakterek engedélyezettek, de egyetlen fájlhoz kell vezetniük. A paraméter értékének megadásakor nem szükséges begépelni FilePath a parancssorba.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:True
DontShow:False

Paraméterkészletek

ByPath
Position:0
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-LiteralPath

Megadja a vizsgált fájl elérési útját. A FilePath-tal ellentétben a LiteralPath paraméter értéke pontosan a beíráskor lesz használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési út tartalmaz egy feloldó karaktert, akkor azt egyes idézőjelek közé kell foglalnia. Az egyszeres idézőjelek azt mondják a PowerShellnek, hogy ne értelmezze a karaktereket escape karakterekként.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:PSPath

Paraméterkészletek

ByLiteralPath
Position:Named
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-SourcePathOrExtension

Annak a tartalomnak a fájljának vagy fájltípusának elérési útja, amelyhez az Authenticode-aláírást lekérte. Ezt a paramétert Tartalom használja, ahol a fájltartalmak bájttömbként vannak átadva.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ByContent
Position:Named
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

String

A parancsmag fájlelérési útvonalát tartalmazó sztringet is beszúrhat.

Kimenetek

Signature

Ez a parancsmag egy aláírási objektumot ad vissza minden egyes lekért aláíráshoz.

Jegyzetek

Ez a parancsmag csak Windows-platformokon érhető el.

További információ az Authenticode-aláírásokról a PowerShellben: about_Signing.