Test-FileCatalog

Referensi

Modul:: Microsoft.PowerShell.Security

Test-FileCatalog memvalidasi apakah hash yang terkandung dalam file katalog (.cat) cocok dengan hash file aktual untuk memvalidasi keasliannya.

Cmdlet ini hanya didukung pada Windows.

Sintaks

Test-FileCatalog
    [-Detailed]
    [-FilesToSkip <String[]>]
    [-CatalogFilePath] <String>
    [[-Path] <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

Test-FileCatalog memvalidasi keaslian file dengan membandingkan hash file file katalog (.cat) dengan hash file aktual pada disk. Jika mendeteksi ketidakcocokan, ia mengembalikan status sebagai ValidationFailed. Pengguna dapat mengambil semua informasi ini dengan menggunakan parameter -Detailed. Ini juga menampilkan status penandatanganan katalog di properti Tanda Tangan, yang setara dengan memanggil cmdlet Get-AuthenticodeSignature pada file katalog. Pengguna juga dapat melewati file apa pun selama validasi dengan menggunakan parameter -FilesToSkip.

Cmdlet ini hanya didukung pada Windows.

Contoh

Contoh 1: Membuat dan memvalidasi katalog file

$NewFileCatalogParams = @{
    Path = "$PSHOME\Modules\Microsoft.PowerShell.Utility"
    CatalogFilePath = "\temp\Microsoft.PowerShell.Utility.cat"
    CatalogVersion = 2.0
}
New-FileCatalog @NewFileCatalogParams

$TestFileCatalogParams = @{
    CatalogFilePath = "\temp\Microsoft.PowerShell.Utility.cat"
    Path = "$PSHOME\Modules\Microsoft.PowerShell.Utility\"
}
Test-FileCatalog @TestFileCatalogParams

Valid

Contoh 2: Memvalidasi katalog file dengan output terperinci

$TestFileCatalogParams = @{
    Detailed = $true
    CatalogFilePath = "\temp\Microsoft.PowerShell.Utility.cat"
    Path = "$PSHOME\Modules\Microsoft.PowerShell.Utility\"
}
Test-FileCatalog @TestFileCatalogParams

Status        : Valid
HashAlgorithm : SHA256
CatalogItems  : {[Microsoft.PowerShell.Utility.psd1,
                A7028BD54018AE519381CDF5BF91F3B0417BD9345478086089ACBFAD05C899FC], [Microsoft.PowerShell.Utility.psm1,
                1127E8151FB86BCB683F932E8F6538552F7195816ED351A28AE07A753B8F20DE]}
PathItems     : {[Microsoft.PowerShell.Utility.psd1,
                A7028BD54018AE519381CDF5BF91F3B0417BD9345478086089ACBFAD05C899FC], [Microsoft.PowerShell.Utility.psm1,
                1127E8151FB86BCB683F932E8F6538552F7195816ED351A28AE07A753B8F20DE]}
Signature     : System.Management.Automation.Signature

Parameter

-CatalogFilePath

Jalur ke file katalog (.cat) yang berisi hash yang akan digunakan untuk validasi.

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

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Jenis:	SwitchParameter
Alias:	cf
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Detailed

Mengembalikan objek CatalogInformation yang lebih rinci yang berisi informasi lebih lengkap mengenai file yang diuji, hash yang diharapkan/aktual, dan tanda tangan Authenticode dari file katalog jika file tersebut sudah ditandatangani.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-FilesToSkip

Sekumpulan jalur yang tidak boleh diuji sebagai bagian dari proses validasi.

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

-Path

Folder atau kumpulan file yang harus divalidasi terhadap file katalog.

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

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet dijalankan. Cmdlet tidak dijalankan.

Jenis:	SwitchParameter
Alias:	wi
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

Input

DirectoryInfo

Anda dapat menyalurkan objek DirectoryInfo yang mewakili jalur ke file yang perlu divalidasi.

String

Anda dapat menyalurkan string yang mewakili jalur ke file yang perlu divalidasi.

Output

CatalogValidationStatus

Secara default, cmdlet ini mengembalikan objek CatalogValidationStatus dengan nilai Valid atau ValidationFailed.

CatalogInformation

Saat Anda menggunakan parameter terperinci, cmdlet mengembalikan objek CatalogInformation untuk setiap file, yang dapat digunakan untuk menganalisis file tertentu yang mungkin lulus atau tidak lulus validasi, hash yang diharapkan dibandingkan dengan yang ditemukan, dan algoritma yang digunakan dalam katalog.

Catatan

Cmdlet ini hanya tersedia di platform Windows.

Bagikan melalui