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.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Confirm

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

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-FilesToSkip

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

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

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

Typ:String[]
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.