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.

Syntax

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

Description

Deze cmdlet is alleen beschikbaar op het Windows-platform.

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 items worden gedetecteerd, wordt de status ValidatieFailed geretourneerd. Gebruikers kunnen al deze informatie ophalen met behulp van de parameter -Detailed. Ook wordt de ondertekeningsstatus van de catalogus weergegeven in de eigenschap Handtekening, die gelijk is aan het aanroepen van Get-AuthenticodeSignature cmdlets in het catalogusbestand. Gebruikers kunnen ook elk bestand overslaan tijdens de validatie met behulp van de parameter -FilesToSkip.

Deze cmdlet wordt alleen ondersteund in Windows.

Voorbeelden

Voorbeeld 1: een bestandscatalogus Creatie 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 met gedetailleerde uitvoer valideren

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
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

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

-Detailed

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

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

-FilesToSkip

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

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

-Path

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

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

-WhatIf

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

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

Invoerwaarden

DirectoryInfo

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

String

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

Uitvoerwaarden

CatalogValidationStatus

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

CatalogInformation

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

Notities

Deze cmdlet is alleen beschikbaar op Windows-platforms.