Sdílet prostřednictvím

Test-FileCatalog

  • Reference
Modul:
Microsoft.PowerShell.Security

Test-FileCatalog ověří, jestli hodnoty hash obsažené v souboru katalogu (.cat) odpovídají hodnotám hash skutečných souborů za účelem ověření jejich pravosti.

Tato rutina se podporuje jenom ve Windows.

Syntaxe

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

Description

Test-FileCatalog ověří pravost souborů porovnáním hodnot hash souborů 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é také můžou 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í.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Detailed

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-FilesToSkip

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

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Path

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

Typ:String[]
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

DirectoryInfo

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

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 Valid nebo ValidationFailed.

CatalogInformation

Když použijete parametr Podrobné, vrátí rutina objekt CatalogInformation pro každý soubor, který lze použít k analýze konkrétních souborů, které mohly nebo nemusely předat ověření, které hodnoty hash byly očekávány a nalezeny, a algoritmus použitý v katalogu.