Delen via

Test-FileCatalog

  • Referentie
Module:
Microsoft.PowerShell.Security

Test-FileCatalog valideert of de hashes in een catalogusbestand (.cat) overeenkomen met de hashes van de werkelijke bestanden om de echtheid ervan te valideren.

Deze cmdlet wordt alleen ondersteund in Windows.

Syntaxis

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

Description

Test-FileCatalog valideert de echtheid van bestanden door de bestands-hashes van een catalogusbestand (.cat) te vergelijken met de hashes van werkelijke bestanden op schijf. Als er niet-overeenkomende fouten worden gedetecteerd, wordt de status geretourneerd als ValidationFailed. Gebruikers kunnen al deze informatie ophalen met behulp van de parameter -Gedetailleerde. Er wordt ook de ondertekeningsstatus van de catalogus weergegeven in de eigenschap Signature, die gelijk is aan het aanroepen van Get-AuthenticodeSignature cmdlets in het catalogusbestand. Gebruikers kunnen ook elk bestand tijdens de validatie overslaan met behulp van de parameter -FilesToSkip.

Deze cmdlet wordt alleen ondersteund in Windows.

Voorbeelden

Voorbeeld 1: Een bestandscatalogus maken en valideren

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

Voorbeeld 2: Een bestandscatalogus valideren met gedetailleerde uitvoer

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

Parameters

-CatalogFilePath

Een pad naar een catalogusbestand (.cat) dat de hashes bevat die moeten worden gebruikt voor validatie.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Detailed

Retourneert meer informatie een gedetailleerder object met de geteste CatalogInformation bestanden, de verwachte/werkelijke hashes en een Authenticode-handtekening van het catalogusbestand als het is ondertekend.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FilesToSkip

Een matrix met paden die niet moeten worden getest als onderdeel van de validatie.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Path

Een map of matrix met bestanden die moeten worden gevalideerd op basis van het catalogusbestand.

Type:String[]
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

DirectoryInfo

U kunt een DirectoryInfo object doorsluisen dat het pad naar de bestanden vertegenwoordigt die moeten worden gevalideerd.

String

U kunt een tekenreeks doorsluisen die het pad naar de bestanden vertegenwoordigt die moeten worden gevalideerd.

Uitvoerwaarden

CatalogValidationStatus

Deze cmdlet retourneert standaard een CatalogValidationStatus-object met een waarde van of Valid ValidationFailed.

CatalogInformation

Wanneer u de parameter Gedetailleerd gebruikt, retourneert de cmdlet een CatalogInformation-object voor elk bestand, dat kan worden gebruikt om specifieke bestanden te analyseren die al dan niet zijn gevalideerd, welke hashes werden verwacht versus gevonden en het algoritme dat in de catalogus wordt gebruikt.