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

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, statusnya akan dikembalikan 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 cmdlet panggilan 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

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.

Type:String
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Detailed

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-FilesToSkip

Array jalur yang tidak boleh diuji sebagai bagian dari validasi.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Path

Folder atau array file yang harus divalidasi terhadap file katalog.

Type:String[]
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Input

DirectoryInfo[], System.String[]

Alur menerima array string atau DirectoryInfo objek yang mewakili jalur ke file yang perlu divalidasi.

Output

CatalogValidationStatus

Jenis pengembalian default yang berisi nilai baik Valid atau ValidationFailed.

CatalogInformation

Objek yang lebih rinci dikembalikan saat menggunakan -Detailed yang dapat digunakan untuk menganalisis file tertentu yang mungkin atau mungkin belum lulus validasi, yang hashnya diharapkan vs. ditemukan, dan algoritma yang digunakan dalam katalog.

Catatan

Cmdlet ini hanya tersedia di platform Windows.