Get-AuthenticodeSignature
A fájl Authenticode-aláírásával kapcsolatos információk lekérdezése.
Syntax
Get-AuthenticodeSignature
[-FilePath] <String[]>
[<CommonParameters>]
Get-AuthenticodeSignature
-LiteralPath <String[]>
[<CommonParameters>]
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 beágyazott aláírt és Windows-katalógus alá van írva, a Rendszer a Windows-katalógus aláírását használja.
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 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 könyvtárban lévő $PSHOME
összes 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ával zárja ki a könyvtárakat (bár a fájlnévben pont nélkül is kizárja a fájlokat).
A parancs egy folyamatkezelővel (|
) küldi a $PSHOME
fájlokat a ForEach-Object
parancsmagba, ahol Get-AuthenticodeSignature
az egyes fájlok meghívása történik.
A parancs eredményeit egy Get-AuthenticodeSignature
olyan parancsnak Where-Object
küldi el a rendszer, 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 a SourcePathOrExtension paraméterrel kell használni. A PowerShell 7.4 előtt a fájl tartalmának Unicode (UTF-16LE) formátumban kell lennie.
Típus: | Byte[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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 a FilePath parancsot a parancssorba.
Típus: | String[] |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | True |
-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írt módon 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 idézőjelek közé kell foglalnia. Az idézőjelek azt mondják a PowerShellnek, hogy ne értelmezzen karaktereket escape karakterként.
Típus: | String[] |
Aliasok: | PSPath |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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 olyan tartalommal használja, amelyben a fájltartalmak bájttömbként vannak átadva.
Típus: | String[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
A parancsmag fájlelérési útvonalát tartalmazó sztringet is beszúrhat.
Kimenetek
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.
Az Authenticode-aláírásokról a PowerShellben a about_Signing című témakörben talál további információt.