Get-AuthenticodeSignature
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 $PSHOME
ForEach-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
Możesz potokować ciąg zawierający ścieżkę pliku do tego polecenia cmdlet.
Dane wyjściowe
To polecenie cmdlet zwraca obiekt podpisu dla każdego odbieranego podpisu.
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.