Test-FileCatalog
Test-FileCatalog
valide si les hachages contenus dans un fichier de 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 status de signature du catalogue dans la propriété Signature, ce qui équivaut à appeler Get-AuthenticodeSignature
l’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
Vous pouvez diriger un DirectoryInfo
objet représentant le chemin vers les fichiers qui doivent être validés.
Vous pouvez diriger une chaîne représentant le chemin vers les fichiers qui doivent être validés.
Sorties
Par défaut, cette applet de Valid
commande renvoie un objet CatalogValidationStatus avec la valeur ou ValidationFailed
.
Lorsque vous utilisez le paramètre Detailed , l’applet de commande renvoie un objet CatalogInformation pour chaque fichier, qui peut être utilisé pour analyser des fichiers spécifiques qui ont ou non réussi la validation, quels hachages étaient attendus et trouvés, et l’algorithme utilisé dans le catalogue.
Notes
Cette applet de commande est disponible uniquement sur les plateformes Windows.