Test-FileCatalog

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

Cette applet de commande est disponible uniquement sur la plateforme Windows.

Test-FileCatalog valide l’authenticité des fichiers en comparant les hachages de fichiers d’un fichier catalogue (.cat) aux hachages de fichiers réels sur le disque. S’il détecte des incompatibilités, il retourne l’état "ValidationFailed." Les utilisateurs peuvent récupérer toutes ces informations à l’aide du paramètre -Detailed. Elle affiche également l'état de signature du catalogue dans la propriété Signature, ce qui équivaut à appeler la cmdlet Get-AuthenticodeSignature sur le fichier de catalogue. Les utilisateurs peuvent également ignorer n’importe quel fichier lors de la validation à l’aide du paramètre -FilesToSkip.

Cette applet de commande est prise en charge uniquement sur 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

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Vous pouvez diriger un objet DirectoryInfo représentant le chemin d’accès aux fichiers qui doivent être validés.

Vous pouvez diriger une chaîne représentant le chemin d’accès aux fichiers qui doivent être validés.

Par défaut, cette applet de commande retourne un objet CatalogValidationStatus avec la valeur Valid ou ValidationFailed.

Lorsque vous utilisez le paramètre Détaillé, l’applet de commande retourne un objet CatalogInformation pour chaque fichier, qui peut être utilisé pour analyser des fichiers spécifiques susceptibles ou non d’avoir réussi la validation, les hachages attendus et l’algorithme utilisé dans le catalogue.

Cette applet de commande est disponible uniquement sur les plateformes Windows.