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 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
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required: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
Required:False
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
Required:False
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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

DirectoryInfo

Anda dapat menyalurkan objek yang DirectoryInfo 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 baik 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 atau mungkin belum lulus validasi, hash mana yang diharapkan vs. ditemukan, dan algoritma yang digunakan dalam katalog.

Catatan

Cmdlet ini hanya tersedia di platform Windows.