Test-FileCatalog
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 bara 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
validerar äktheten hos filer genom att jämföra filhashher för en katalogfil (.cat) med hashvärden för faktiska filer på disken. Om den identifierar matchningsfel 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
cmdleten i katalogfilen. Användare kan också hoppa över alla filer under valideringen med hjälp av parametern -FilesToSkip.
Den här cmdleten stöds bara 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
Du kan skicka ett DirectoryInfo
objekt som representerar sökvägen till de filer som behöver verifieras.
Du kan skicka en sträng som representerar sökvägen till de filer som behöver verifieras.
Utdata
Som standard returnerar den här cmdleten ett CatalogValidationStatus-objekt med värdet antingen Valid
eller ValidationFailed
.
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 den algoritm som används i katalogen.
Kommentarer
Den här cmdleten är endast tillgänglig på Windows-plattformar.