Dela via

Test-FileCatalog

  • Referens
Modul:
Microsoft.PowerShell.Security

Test-FileCatalog verifierar om hashvärdena i en katalogfil (.cat) matchar hashvärdena för de faktiska filerna för att verifiera deras äkthet.

Den här cmdleten stöds endast i Windows.

Syntax

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

Description

Den här cmdleten är endast tillgänglig på Windows-plattformen.

Test-FileCatalog verifierar filernas äkthet genom att jämföra filhasharna för en katalogfil (.cat) med hashvärden för faktiska filer på disken. Om den identifierar eventuella matchningar returneras statusen ValidationFailed. Användare kan hämta all den här informationen med hjälp av parametern -Detailed. Den visar också signeringsstatus för katalogen i egenskapen Signatur, vilket motsvarar att anropa Get-AuthenticodeSignature cmdlet på katalogfilen. Användare kan också hoppa över valfri fil under valideringen med parametern -FilesToSkip.

Den här cmdleten stöds endast i Windows.

Exempel

Exempel 1: Skapa och verifiera en filkatalog

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

Exempel 2: Verifiera en filkatalog med detaljerade utdata

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

Parametrar

-CatalogFilePath

En sökväg till en katalogfil (.cat) som innehåller de hashvärden som ska användas för validering.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-Detailed

Returnerar mer information om ett mer detaljerat CatalogInformation objekt som innehåller de testade filerna, deras förväntade/faktiska hashvärden och en Authenticode-signatur för katalogfilen om den är signerad.

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

-FilesToSkip

En matris med sökvägar som inte ska testas som en del av valideringen.

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

-Path

En mapp eller matris med filer som ska verifieras mot katalogfilen.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Indata

DirectoryInfo

Du kan skicka ett DirectoryInfo objekt som representerar sökvägen till de filer som måste verifieras.

String

Du kan skicka en sträng som representerar sökvägen till de filer som måste verifieras.

Utdata

CatalogValidationStatus

Som standard returnerar den här cmdleten ett CatalogValidationStatus-objekt med värdet antingen Valid eller ValidationFailed.

CatalogInformation

När du använder parametern Detaljerad returnerar cmdleten ett CatalogInformation-objekt för varje fil, som kan användas för att analysera specifika filer som kanske eller kanske inte har godkänt valideringen, vilka hashvärden som förväntades jämfört med de som hittades och algoritmen som används i katalogen.

Kommentarer

Den här cmdleten är endast tillgänglig på Windows-plattformar.