Test-FileCatalog
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
Default (Default)
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 panggilan Get-AuthenticodeSignature cmdlet 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
New-FileCatalog -Path $PSHOME\Modules\Microsoft.PowerShell.Utility -CatalogFilePath \temp\Microsoft.PowerShell.Utility.cat -CatalogVersion 2.0
Test-FileCatalog -CatalogFilePath \temp\Microsoft.PowerShell.Utility.cat -Path "$PSHOME\Modules\Microsoft.PowerShell.Utility\"
Valid
Contoh 2: Memvalidasi katalog file dengan output terperinci
Test-FileCatalog -Detailed -CatalogFilePath \temp\Microsoft.PowerShell.Utility.cat -Path "$PSHOME\Modules\Microsoft.PowerShell.Utility\"
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.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Confirm
Meminta konfirmasi sebelum menjalankan cmdlet.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | Cf |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | 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.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-FilesToSkip
Sekumpulan jalur yang tidak boleh diuji sebagai bagian dari proses validasi.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Path
Folder atau kumpulan file yang harus divalidasi terhadap file katalog.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | 1 |
| Wajib: | False |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-WhatIf
Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | wi |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| 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
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
CatalogInformation
Saat Anda menggunakan parameter terperinci , cmdlet mengembalikan objek CatalogInformation untuk setiap file, yang dapat digunakan untuk menganalisis file-file tertentu yang mungkin atau mungkin belum lulus validasi, mana hash yang diharapkan dibandingkan dengan yang ditemukan, dan algoritma yang digunakan dalam katalog.
Catatan
Cmdlet ini hanya tersedia di platform Windows.
