New-FileCatalog

Module:
Microsoft.PowerShell.Security Module

New-FileCatalog crée un fichier catalogue de hachages de fichiers qui peuvent être utilisés pour valider l’authenticité d’un fichier.

Syntaxe

Default (Par défaut) 

New-FileCatalog
    [-CatalogVersion <Int32>]
    [-CatalogFilePath] <String>
    [[-Path] <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

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

New-FileCatalog crée un fichier catalogue Windows pour un ensemble de dossiers et de fichiers. Ce fichier de catalog contient des hachages pour tous les fichiers dans les chemins fournis. Les utilisateurs peuvent ensuite distribuer le catalogue avec leurs fichiers afin que les utilisateurs puissent vérifier si des modifications ont été apportées aux dossiers depuis la création du catalogue.

Les versions de catalogue 1 et 2 sont prises en charge. La version 1 utilise l’algorithme de hachage SHA1 (déconseillé) pour créer des hachages de fichiers et la version 2 utilise SHA256.

Exemples

Exemple 1 : Créer un catalogue de fichiers pour « Microsoft.PowerShell.Utility »

New-FileCatalog -Path $PSHOME\Modules\Microsoft.PowerShell.Utility -CatalogFilePath \temp\Microsoft.PowerShell.Utility.cat -CatalogVersion 2.0

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         11/2/2018 11:58 AM            950 Microsoft.PowerShell.Utility.cat

Paramètres

-CatalogFilePath

Chemin d’accès à un fichier ou à un dossier dans lequel le fichier catalogue (.cat) doit être placé. Si un chemin d’accès au dossier est spécifié, le nom catalog.cat de fichier par défaut sera utilisé.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-CatalogVersion

Accepte 1.0 ou 2.0 comme valeurs possibles pour spécifier la version du catalogue. 1.0 doit être évité dans la mesure du possible, car il utilise l’algorithme de hachage non sécurisé SHA-1, tandis qu’il 2.0 utilise l’algorithme sécurisé SHA-256 Cependant, 1.0 est le seul algorithme pris en charge sur Windows 7 et Server 2008R2.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Path

Accepte un chemin d’accès ou un tableau de chemins d’accès aux fichiers ou dossiers qui doivent être inclus dans le fichier catalogue. Si un dossier est spécifié, tous les fichiers qu’il contient seront également inclus.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

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.

Entrées

String

Vous pouvez rediriger une chaîne utilisée comme nom de fichier catalogue vers cette applet de commande.

Sorties

FileInfo

Cette applet de commande retourne un objet FileInfo représentant le catalogue créé.

Notes

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