Partager via

New-FileCatalog

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

Crée un fichier catalogue Windows contenant des hachages de chiffrement pour les fichiers et dossiers dans les chemins spécifiés.

Syntaxe

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

Description

New-FileCatalog crée un fichier catalogue Windows pour un ensemble de dossiers et de fichiers. Ce fichier catalogue contient des hachages pour tous les fichiers dans les chemins d’accès 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 catalogues 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 »

$newFileCatalogSplat = @{
    Path = "$PSHOME\Modules\Microsoft.PowerShell.Utility"
    CatalogFilePath = '\temp\Microsoft.PowerShell.Utility.cat'
    CatalogVersion = 2.0
}
New-FileCatalog @newFileCatalogSplat

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

Paramètres

-CatalogFilePath

Emplacement et nom du fichier catalogue (.cat) que vous créez. Si vous spécifiez uniquement un chemin d’accès au dossier, la commande crée un fichier nommé catalog.cat à cet emplacement.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-CatalogVersion

Accepte 1.0 ou 2.0 accepte les 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 SHA-1 non sécurisé. La version 2.0 utilise l’algorithme SHA-256 sécurisé.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous demande une confirmation avant d’exécuter la commande cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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é, la commande inclut tous les fichiers du dossier.

Type:String[]
Position:1
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

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

Sorties

FileInfo

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