Partager via

Test-FileCatalog

  • Référence
Module:
Microsoft.PowerShell.Security

Test-FileCatalog vérifie si les hachages contenus dans un fichier catalogue (.cat) correspondent aux hachages des fichiers réels afin de valider leur authenticité.

Cette applet de commande est uniquement prise en charge sur Windows.

Syntax

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

Description

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

Test-FileCatalog valide l’authenticité des fichiers en comparant les hachages de fichier d’un fichier catalogue (.cat) avec les hachages des fichiers réels sur le disque. S’il détecte des incompatibilités, il retourne le status comme ValidationFailed. Les utilisateurs peuvent récupérer toutes ces informations à l’aide du paramètre -Detailed. Il affiche également la signature status du catalogue dans la propriété Signature qui équivaut à l’appel Get-AuthenticodeSignature d’applet de commande sur le fichier catalogue. Les utilisateurs peuvent également ignorer des fichiers lors de la validation à l’aide du paramètre -FilesToSkip.

Cette applet de commande est uniquement prise en charge sur Windows.

Exemples

Exemple 1 : Create et valider un catalogue de fichiers

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

Exemple 2 : Valider un catalogue de fichiers avec une sortie détaillée

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

Paramètres

-CatalogFilePath

Chemin d’accès à un fichier catalogue (.cat) qui contient les hachages à utiliser pour la validation.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Detailed

Retourne plus d’informations un objet plus détaillé CatalogInformation qui contient les fichiers testés, leurs hachages attendus/réels et une signature Authenticode du fichier catalogue s’il est signé.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FilesToSkip

Tableau de chemins qui ne doivent pas être testés dans le cadre de la validation.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Dossier ou tableau de fichiers qui doivent être validés par rapport au fichier catalogue.

Type:String[]
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

DirectoryInfo[], System.String[]

Le pipeline accepte un tableau de chaînes ou DirectoryInfo d’objets qui représentent des chemins d’accès aux fichiers qui doivent être validés.

Sorties

CatalogValidationStatus

Type de retour par défaut contenant la valeur ou ValidValidationFailed.

CatalogInformation

Objet plus détaillé retourné lors de l’utilisation -Detailed qui peut être utilisé pour analyser des fichiers spécifiques qui ont ou non réussi la validation, quels hachages étaient attendus ou trouvés, et l’algorithme utilisé dans le catalogue.

Notes

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