Test-FileCatalog

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

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 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 hjälp av parametern -FilesToSkip.

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

$NewFileCatalogParams = @{
    Path = "$PSHOME\Modules\Microsoft.PowerShell.Utility"
    CatalogFilePath = "\temp\Microsoft.PowerShell.Utility.cat"
    CatalogVersion = 2.0
}
New-FileCatalog @NewFileCatalogParams

$TestFileCatalogParams = @{
    CatalogFilePath = "\temp\Microsoft.PowerShell.Utility.cat"
    Path = "$PSHOME\Modules\Microsoft.PowerShell.Utility\"
}
Test-FileCatalog @TestFileCatalogParams

Valid

$TestFileCatalogParams = @{
    Detailed = $true
    CatalogFilePath = "\temp\Microsoft.PowerShell.Utility.cat"
    Path = "$PSHOME\Modules\Microsoft.PowerShell.Utility\"
}
Test-FileCatalog @TestFileCatalogParams

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

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.

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

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

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 förväntades jämfört med de som hittades, och algoritmen som används i katalogen.

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