Partage 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.

Syntax

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 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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
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

-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
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

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éé.

Notes

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