Dela via

Test-FileCatalog

Modul:
Microsoft.PowerShell.Security Module

Test-FileCatalog kontrollerar 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

Default (Standard) 

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 fil-hashvärden för en katalogfil (.cat) med hashvärden för faktiska filer på disken. Om den identifierar eventuella matchningar returneras statusen ValidationFailed. Användarna kan hämta all den här informationen med hjälp av parametern -Detailed. Den visar även 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 hjälp av 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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Confirm

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Detailed

Returnerar mer information en mer detaljerad 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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-FilesToSkip

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Path

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:1
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

DirectoryInfo

Pipelinen accepterar en matris med strängar eller DirectoryInfo objekt som representerar sökvägar till de filer som behöver verifieras.

Utdata

CatalogValidationStatus

Standardreturtypen som innehåller värdet antingen Valid eller ValidationFailed.

CatalogInformation

Ett mer detaljerat objekt som returneras vid användning -Detailed och som kan användas för att analysera specifika filer som kan ha klarat valideringen eller inte, vilka hashvärden som förväntades jämfört med hittades och algoritmen som används i katalogen.

Kommentarer

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