Udostępnij za pośrednictwem

Get-AuthenticodeSignature

  • Odwołanie
Moduł:
Microsoft.PowerShell.Security

Pobiera informacje o podpisie Authenticode dla pliku.

Składnia

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

Opis

To polecenie cmdlet jest dostępne tylko na platformie Windows.

Polecenie cmdlet Get-AuthenticodeSignature pobiera informacje o podpisie Authenticode dla pliku lub zawartości pliku jako tablicy bajtów. Jeśli plik jest podpisany zarówno osadzony, jak i podpisany wykaz systemu Windows, używany jest podpis katalogu systemu Windows. Jeśli plik nie jest podpisany, informacje są pobierane, ale pola są puste.

Przykłady

Przykład 1. Pobieranie podpisu Authenticode dla pliku

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

To polecenie pobiera informacje o podpisie Authenticode w pliku NewScript.ps1. Do określenia pliku jest używany parametr FilePath.

Przykład 2. Pobieranie podpisu Authenticode dla wielu plików

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

To polecenie pobiera informacje o podpisie Authenticode dla czterech plików wymienionych w wierszu polecenia. W tym przykładzie pominięto nazwę parametru FilePath, który jest opcjonalny.

Przykład 3. Pobieranie tylko prawidłowych podpisów Authenticode dla wielu plików

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

To polecenie wyświetla listę wszystkich plików w katalogu $PSHOME, które mają prawidłowy podpis Authenticode. Zmienna automatyczna $PSHOME zawiera ścieżkę do katalogu instalacyjnego programu PowerShell.

Polecenie używa polecenia cmdlet Get-ChildItem do pobrania plików w katalogu $PSHOME. Używa wzorca . wykluczać katalogi (chociaż wyklucza również pliki bez kropki w nazwie pliku).

Polecenie używa operatora potoku (|) do wysyłania plików w $PSHOME do polecenia cmdlet ForEach-Object, gdzie Get-AuthenticodeSignature jest wywoływana dla każdego pliku.

Wyniki polecenia Get-AuthenticodeSignature są wysyłane do polecenia Where-Object, które wybiera tylko obiekty podpisu ze stanem Prawidłowy.

Przykład 4. Pobieranie podpisu Authenticode dla zawartości pliku określonej jako tablica bajtów

$authenticodeSignatureParams = @{
    Content = (Get-Content foo.ps1 -AsByteStream)
    SourcePathorExtension = "ps1"
}
Get-AuthenticodeSignature @authenticodeSignatureParams

To polecenie pobiera informacje o podpisie Authenticode dla zawartości pliku. W tym przykładzie rozszerzenie pliku jest określane wraz z zawartością pliku.

Parametry

-Content

Zawartość pliku jako tablicy bajtów, dla której jest pobierany podpis Authenticode. Ten parametr musi być używany z parametrem SourcePathOrExtension. Przed programem PowerShell 7.4 zawartość pliku musi być w formacie Unicode (UTF-16LE).

Typ:Byte[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-FilePath

Określa ścieżkę do pliku do zbadania. Dozwolone są symbole wieloznaczne, ale muszą prowadzić do pojedynczego pliku. Podczas określania wartości dla tego parametru nie trzeba wpisywać FilePath w wierszu polecenia.

Typ:String[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-LiteralPath

Określa ścieżkę do badanego pliku. W przeciwieństwie do FilePathwartość parametru LiteralPath jest używana dokładnie tak, jak jest typowana. Znaki nie są interpretowane jako symbole wieloznaczne. Jeśli ścieżka zawiera znak ucieczki, należy go ująć w pojedynczy cudzysłów. Znaki pojedynczego cudzysłowu informują program PowerShell, aby nie interpretował żadnych znaków jako znaków ucieczki.

Typ:String[]
Aliasy:PSPath, LP
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SourcePathOrExtension

Ścieżka do pliku lub typu pliku zawartości, dla której jest pobierany podpis Authenticode. Ten parametr jest używany z Content, gdzie zawartość pliku jest przekazywana jako tablica bajtów.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Możesz potokować ciąg zawierający ścieżkę pliku do tego polecenia cmdlet.

Dane wyjściowe

Signature

To polecenie cmdlet zwraca obiekt podpisu dla każdego odbieranego podpisu.

Uwagi

To polecenie cmdlet jest dostępne tylko na platformach windows.

Aby uzyskać informacje na temat podpisów Authenticode w programie PowerShell, zobacz about_Signing.