Sdílet prostřednictvím

Get-AuthenticodeSignature

  • Reference
Modul:
Microsoft.PowerShell.Security

Získá informace o podpisu Authenticode pro soubor.

Syntaxe

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

Description

Tato rutina je dostupná jenom na platformě Windows.

Rutina Get-AuthenticodeSignature získá informace o podpisu Authenticode pro soubor nebo obsah souboru jako pole bajtů. Pokud je soubor vložený podepsaný i podepsaný katalog Windows, použije se podpis katalogu Systému Windows. Pokud soubor není podepsaný, informace se načtou, ale pole jsou prázdná.

Příklady

Příklad 1: Získání podpisu Authenticode pro soubor

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

Tento příkaz získá informace o podpisu Authenticode v souboru NewScript.ps1. K určení souboru se používá parametr FilePath .

Příklad 2: Získání podpisu Authenticode pro více souborů

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

Tento příkaz získá informace o podpisu Authenticode pro čtyři soubory uvedené na příkazovém řádku. V tomto příkladu se vynechá název parametru FilePath , který je volitelný.

Příklad 3: Získání pouze platných podpisů Authenticode pro více souborů

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

Tento příkaz zobrazí seznam všech souborů v $PSHOME adresáři, které mají platný podpis Authenticode. Automatická $PSHOME proměnná obsahuje cestu k instalačnímu adresáři PowerShellu.

Příkaz pomocí rutiny Get-ChildItem získá soubory v $PSHOME adresáři. Používá vzor . k vyloučení adresářů (i když také vylučuje soubory bez tečky v názvu souboru).

Příkaz používá operátor kanálu (|) k odeslání souborů $PSHOME do rutiny ForEach-Object , kde Get-AuthenticodeSignature se volá pro každý soubor.

Výsledky Get-AuthenticodeSignature příkazu se odešlou do Where-Object příkazu, který vybere pouze objekty podpisu se stavem Valid.

Příklad 4: Získání podpisu Authenticode pro obsah souboru určený jako pole bajtů

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

Tento příkaz získá informace o podpisu Authenticode pro obsah souboru. V tomto příkladu je přípona souboru zadána spolu s obsahem souboru.

Parametry

-Content

Obsah souboru jako pole bajtů, pro které je načten podpis Authenticode. Tento parametr musí být použit s parametrem SourcePathOrExtension . Před PowerShellem 7.4 musí být obsah souboru ve formátu Unicode (UTF-16LE).

Typ:Byte[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-FilePath

Určuje cestu k souboru, který chcete prozkoumat. Zástupné cardy jsou povolené, ale musí vést k jednomu souboru. Při zadání hodnoty pro tento parametr není nutné na příkazovém řádku zadat FilePath .

Typ:String[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-LiteralPath

Určuje cestu k souboru, který se zkoumá. Na rozdíl od FilePath se hodnota parametru LiteralPath používá přesně tak, jak je zadána. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje řídicí znak, uzavřete ho do jednoduchých uvozovek. Jednoduché uvozovky říkají PowerShellu, aby nepřekládaly žádné znaky jako řídicí znaky.

Typ:String[]
Aliasy:PSPath
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SourcePathOrExtension

Cesta k souboru nebo typu souboru obsahu, pro který je načten podpis Authenticode. Tento parametr se používá s obsahem, kde se obsah souboru předává jako pole bajtů.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

String

K této rutině můžete připojit řetězec, který obsahuje cestu k souboru.

Výstupy

Signature

Tato rutina vrátí objekt podpisu pro každý podpis, který získá.

Poznámky

Tato rutina je dostupná jenom na platformách Windows.

Informace o podpisech Authenticode v PowerShellu najdete v tématu about_Signing.