Test-FileCatalog
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.
Syntaxe
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í.
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 zobrazí výzvu 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í 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ý.
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
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
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
Objekt představující cestu k souborům, které je potřeba ověřit, můžete pipetovat DirectoryInfo
.
Řetězec představující cestu k souborům, které je potřeba ověřit, můžete pipetovat.
Výstupy
Ve výchozím nastavení vrátí tato rutina objekt CatalogValidationStatus s hodnotou buď Valid
nebo ValidationFailed
.
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.