Test-FileCatalog

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

Deze cmdlet is alleen beschikbaar op het Windows-platform.

Test-FileCatalog valideert de echtheid van bestanden door de bestands-hashes van een catalogusbestand (.cat) te vergelijken met de hashes van werkelijke bestanden op schijf. Als er verschillen worden gedetecteerd, wordt de status teruggegeven als ValidationFailed. Gebruikers kunnen al deze informatie ophalen met behulp van de parameter -Detailed. Ook wordt de ondertekeningsstatus van de catalogus weergegeven in de eigenschap Signature, wat gelijk is aan het aanroepen van Get-AuthenticodeSignature cmdlet in het catalogusbestand. Gebruikers kunnen ook elk bestand tijdens de validatie overslaan met behulp van de parameter -FilesToSkip.

Deze cmdlet wordt alleen ondersteund in 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

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt een DirectoryInfo object doorsluisen dat het pad naar de bestanden vertegenwoordigt die moeten worden gevalideerd.

U kunt een tekenreeks doorsluisen die het pad naar de bestanden vertegenwoordigt die moeten worden gevalideerd.

Deze cmdlet retourneert standaard een CatalogValidationStatus-object met een waarde van Valid of ValidationFailed.

Wanneer u de parameter Gedetailleerde gebruikt, retourneert de cmdlet een CatalogInformation-object voor elk bestand, dat kan worden gebruikt om specifieke bestanden te analyseren die al dan niet zijn gevalideerd, welke hashes werden verwacht versus gevonden en het algoritme dat in de catalogus wordt gebruikt.

Deze cmdlet is alleen beschikbaar op Windows-platforms.