Test-FileCatalog

Modul:

Microsoft.PowerShell.Security Module

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.

Tento cmdlet je podporován pouze na Windows.

Syntaxe

Default (Výchozí)

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 souborů katalogu (.cat) s hodnotami hash skutečných souborů na disku. Pokud zjistí jakékoli neshody, vrátí stav jako ValidationFailed. Uživatelé mohou načíst všechny tyto informace pomocí parametru -Detailed. Zobrazuje také stav podpisu katalogu v atributu Podpis, což odpovídá použití příkazového modulu Get-AuthenticodeSignature na soubor katalogu. Uživatelé také můžou během ověřování přeskočit libovolný soubor pomocí parametru -FilesToSkip.

Tento cmdlet je podporován pouze na Windows.

Příklady

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

$NewFileCatalogParams = @{
    Path = "$PSHOME\Modules\Microsoft.PowerShell.Utility"
    CatalogFilePath = "\temp\Microsoft.PowerShell.Utility.cat"
    CatalogVersion = 2.0
}
New-FileCatalog @NewFileCatalogParams

$TestFileCatalogParams = @{
    CatalogFilePath = "\temp\Microsoft.PowerShell.Utility.cat"
    Path = "$PSHOME\Modules\Microsoft.PowerShell.Utility\"
}
Test-FileCatalog @TestFileCatalogParams

Valid

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

$TestFileCatalogParams = @{
    Detailed = $true
    CatalogFilePath = "\temp\Microsoft.PowerShell.Utility.cat"
    Path = "$PSHOME\Modules\Microsoft.PowerShell.Utility\"
}
Test-FileCatalog @TestFileCatalogParams

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í.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	0
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Confirm

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	viz

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Detailed

Vrátí podrobnější CatalogInformation objekt, který poskytuje více informací, včetně otestovaných souborů, jejich očekávaných a skutečných hodnot hash a podpisu Authenticode souboru katalogu, pokud je tento podepsán.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-FilesToSkip

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

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Path

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

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	1
Povinné:	False
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Wi

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

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.

Poznámky

Tento cmdlet je dostupný pouze na platformách Windows.

Související odkazy

• New-FileCatalog
• PowerShellGet