Bagikan melalui

Get-AuthenticodeSignature

  • Referensi
Modul:
Microsoft.PowerShell.Security

Mendapatkan informasi tentang tanda tangan Authenticode untuk file.

Sintaks

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

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

Get-AuthenticodeSignature Cmdlet 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 $PSHOME direktori yang memiliki tanda tangan Authenticode yang valid. Variabel $PSHOME otomatis berisi jalur ke direktori penginstalan PowerShell.

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

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

Hasil Get-AuthenticodeSignature perintah dikirim ke Where-Object perintah 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).

Jenis:Byte[]
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-FilePath

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

Jenis:String[]
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:True

-LiteralPath

Menentukan jalur ke file yang sedang diperiksa. Tidak seperti FilePath, nilai parameter LiteralPath digunakan persis seperti yang ditik. Tidak ada karakter yang ditafsirkan sebagai kartubebas. 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.

Jenis:String[]
Alias:PSPath
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-SourcePathOrExtension

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

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

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.