Get-AuthenticodeSignature
Získá informace o podpisu Authenticode pro soubor.
Syntaxe
ByPath (Výchozí)
Get-AuthenticodeSignature
[-FilePath] <String[]>
[<CommonParameters>]
ByLiteralPath
Get-AuthenticodeSignature
-LiteralPath <String[]>
[<CommonParameters>]
ByContent
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 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ů
$authenticodeSignatureParams = @{
Content = (Get-Content foo.ps1 -AsByteStream)
SourcePathorExtension = "ps1"
}
Get-AuthenticodeSignature @authenticodeSignatureParams
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).
Vlastnosti parametru
| Typ: | Byte[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ByContent
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
ByPath
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-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ý znak není interpretován jako zástupný znak. 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.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | PSPath, PO |
Sady parametrů
ByLiteralPath
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | 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ů.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ByContent
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
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
Tento cmdlet je dostupný pouze na platformách Windows.
Informace o podpisech Authenticode v PowerShellu najdete v tématu about_Signing.
