Udostępnij za pośrednictwem

Get-AuthenticodeSignature

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

Pobiera informacje o sygnaturze 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 Get-AuthenticodeSignature cmdlet pobiera informacje o sygnaturze Authenticode dla pliku lub zawartości pliku jako tablicy bajtów. Jeśli plik jest zarówno podpisany, jak i podpisany w katalogu systemu Windows, używany jest podpis wykazu 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 sygnaturze Authenticode w pliku NewScript.ps1. Używa parametru FilePath do określenia pliku.

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 sygnaturze Authenticode dla czterech plików wymienionych w wierszu polecenia. W tym przykładzie nazwa parametru FilePath , który jest opcjonalny, zostanie pominięty.

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 $PSHOME katalogu, które mają prawidłowy podpis Authenticode. Zmienna automatyczna $PSHOME zawiera ścieżkę do katalogu instalacyjnego programu PowerShell.

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

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

Wyniki Get-AuthenticodeSignature polecenia są wysyłane do Where-Object polecenia, 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

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

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

Parametry

-Content

Zawartość pliku jako tablicy bajtów, dla której jest pobierana sygnatura Authenticode. Ten parametr musi być używany z parametrem SourcePathOrExtension . Zawartość pliku musi być w formacie Unicode (UTF-16LE).

Type:Byte[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-FilePath

Określa ścieżkę do pliku do zbadania. Symbole wieloznaczne są dozwolone, ale muszą prowadzić do pojedynczego pliku. Nie jest konieczne wpisywanie parametru FilePath w wierszu polecenia po określeniu wartości dla tego parametru.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-LiteralPath

Określa ścieżkę do badanego pliku. W przeciwieństwie do parametru FilePath wartość 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.

Type:String[]
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SourcePathOrExtension

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Dane wejściowe

String

Możesz potokować ciąg zawierający ścieżkę pliku do Get-AuthenticodeSignature.

Dane wyjściowe

Signature

Get-AuthenticodeSignature zwraca obiekt podpisu dla każdego sygnatury, który otrzymuje.

Uwagi

To polecenie cmdlet jest dostępne tylko na platformach systemu Windows.

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