Test-FileCatalog

  • Reference
Modul:
Microsoft.PowerShell.Security

Test-FileCatalog ověřuje, zda hodnoty hash obsažené v souboru katalogu (.cat) odpovídají hodnotám hash skutečných souborů, aby bylo možné ověřit jejich pravost.

Tato rutina se podporuje jenom ve Windows.

Syntax

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

Description

Tato rutina je dostupná jenom na platformě Windows.

Test-FileCatalog ověří pravost souborů porovnáním hodnot hash souboru katalogu (.cat) s hodnotami hash skutečných souborů na disku. Pokud zjistí případné neshody, vrátí stav Jako ValidationFailed. Uživatelé mohou načíst všechny tyto informace pomocí parametru -Detailed. Zobrazuje také stav podepisování katalogu ve vlastnosti Signature, která odpovídá volání Get-AuthenticodeSignature rutiny v souboru katalogu. Uživatelé mohou také během ověřování přeskočit libovolný soubor pomocí parametru -FilesToSkip.

Tato rutina se podporuje jenom ve Windows.

Příklady

Příklad 1: Vytvoření a ověření katalogu souborů

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

Příklad 2: Ověření katalogu souborů s podrobným výstupem

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

Parametry

-CatalogFilePath

Cesta k souboru katalogu (.cat), který obsahuje hodnoty hash, které se mají použít k ověření.

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Detailed

Vrátí další informace o podrobnějším CatalogInformation objektu, který obsahuje otestované soubory, jejich očekávané a skutečné hodnoty hash a podpis Authenticode souboru katalogu, pokud je podepsaný.

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

-FilesToSkip

Pole cest, které by se nemělo testovat jako součást ověření.

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

-Path

Složka nebo pole souborů, které by se měly ověřit v souboru katalogu.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Vstupy

DirectoryInfo

Objekt představující cestu k souborům, které je potřeba ověřit, můžete pipetovat DirectoryInfo .

String

Řetězec představující cestu k souborům, které je potřeba ověřit, můžete pipetovat.

Výstupy

CatalogValidationStatus

Ve výchozím nastavení vrátí tato rutina objekt CatalogValidationStatus s hodnotou buď Valid nebo ValidationFailed.

CatalogInformation

Při použití podrobného parametru vrátí rutina objekt CatalogInformation pro každý soubor, který lze použít k analýze konkrétních souborů, které mohou nebo nebyly předány ověření, které hodnoty hash byly očekávány a nalezeny a algoritmus použitý v katalogu.

Poznámky

Tato rutina je dostupná jenom na platformách Windows.