Bagikan melalui

Get-AuthenticodeSignature

Modul:
Microsoft.PowerShell.Security Module

Mendapatkan informasi tentang tanda tangan Authenticode untuk file.

Sintaks

ByPath (Default) 

Get-AuthenticodeSignature
    [-FilePath] <String[]>
    [<CommonParameters>]

ByLiteralPath 

Get-AuthenticodeSignature
    -LiteralPath <String[]>
    [<CommonParameters>]

ByContent 

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

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

Cmdlet Get-AuthenticodeSignature mendapatkan informasi tentang tanda tangan Authenticode untuk file atau konten file sebagai array byte. Jika file ditandatangani dan katalog Windows ditandatangani, tanda tangan katalog Windows digunakan. Jika file tidak ditandatangani, informasi diambil, tetapi bidang kosong.

Contoh

Contoh 1: Mendapatkan tanda tangan Authenticode untuk file

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

Perintah ini mendapatkan informasi tentang tanda tangan Authenticode dalam file NewScript.ps1. Ini menggunakan parameter FilePath untuk menentukan file.

Contoh 2: Dapatkan tanda tangan Authenticode untuk beberapa file

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

Perintah ini mendapatkan informasi tentang tanda tangan Authenticode untuk empat file yang tercantum di baris perintah. Dalam contoh ini, nama parameter FilePath , yang bersifat opsional, dihilangkan.

Contoh 3: Hanya dapatkan tanda tangan Authenticode yang valid untuk beberapa file

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

Perintah ini mencantumkan semua file dalam direktori $PSHOME yang memiliki tanda tangan Authenticode yang valid. Variabel otomatis $PSHOME berisi jalur ke direktori penginstalan PowerShell.

Perintah menggunakan cmdlet Get-ChildItem untuk mendapatkan file di direktori $PSHOME. Ini menggunakan pola . untuk mengecualikan direktori (meskipun juga mengecualikan file tanpa titik dalam nama file).

Perintah menggunakan operator alur (|) untuk mengirim file dalam $PSHOME ke cmdlet ForEach-Object, di mana Get-AuthenticodeSignature dipanggil untuk setiap file.

Hasil perintah Get-AuthenticodeSignature dikirim ke perintah Where-Object yang hanya memilih objek tanda tangan dengan status Valid.

Contoh 4: Dapatkan tanda tangan Authenticode untuk konten file yang ditentukan sebagai array byte

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

Perintah ini mendapatkan informasi tentang tanda tangan Authenticode untuk konten file. Dalam contoh ini, ekstensi file ditentukan bersama dengan konten file.

Parameter

-Content

Konten file sebagai array byte tempat tanda tangan Authenticode diambil. Parameter ini harus digunakan dengan parameter SourcePathOrExtension. Sebelum PowerShell 7.4, konten file harus dalam format Unicode (UTF-16LE).

Properti parameter

Jenis:

Byte[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

ByContent
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-FilePath

Menentukan jalur ke file yang akan diperiksa. Kartubebas diizinkan, tetapi harus mengarah ke satu file. Tidak perlu mengetik FilePath di baris perintah saat Anda menentukan nilai untuk parameter ini.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:True
DontShow:False

Kumpulan parameter

ByPath
Position:0
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-LiteralPath

Menentukan jalur ke file yang sedang diperiksa. Tidak seperti FilePath, nilai parameter LiteralPath digunakan persis seperti yang diketik. Tidak ada karakter yang ditafsirkan sebagai wildcard. Jika jalur menyertakan karakter escape, sertakan dalam tanda kutip tunggal. Tanda kutip tunggal memberi tahu PowerShell untuk tidak menginterpretasikan karakter apa pun sebagai karakter escape.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:PSPath, LP

Kumpulan parameter

ByLiteralPath
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-SourcePathOrExtension

Jalur ke file atau tipe file konten tempat tanda tangan Authenticode diambil. Parameter ini digunakan dengan Content di mana konten file diteruskan sebagai array byte.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

ByContent
Position:Named
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

String

Anda dapat menyalurkan string yang berisi jalur file ke cmdlet ini.

Output

Signature

Cmdlet ini mengembalikan objek tanda tangan untuk setiap tanda tangan yang didapatkannya.

Catatan

Cmdlet ini hanya tersedia di platform Windows.

Untuk informasi tentang tanda tangan Authenticode di PowerShell, lihat about_Signing.