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

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 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 adresáři $PSHOME, které mají platný podpis Authenticode. Automatická proměnná $PSHOME obsahuje cestu k instalačnímu adresáři PowerShellu.

Příkaz používá rutinu Get-ChildItem k získání souborů v adresáři $PSHOME. Používá vzor . vyloučit adresáře (i když vyloučí soubory bez tečky v názvu souboru).

Příkaz pomocí operátoru kanálu (|) odešle soubory v $PSHOME do rutiny ForEach-Object, kde se pro každý soubor volá Get-AuthenticodeSignature.

Výsledky příkazu Get-AuthenticodeSignature se odesílají do příkazu Where-Object, 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. Obsah souboru musí být 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é zadat FilePath na příkazovém řádku.

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 FilePathse hodnota parametru LiteralPath používá přesně tak, jak je zadán. Žá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 Content, 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

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