New-FileCatalog
Crée un fichier de catalogue Windows contenant des hachages de chiffrement pour les fichiers et dossiers dans les chemins d’accès spécifiés.
Syntaxe
Default (Par défaut)
New-FileCatalog
[-CatalogVersion <Int32>]
[-CatalogFilePath] <String>
[[-Path] <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Applet de commandeThis est disponible uniquement sur la plateforme Windows platform.
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 »
$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 () que vous créez. Si vous spécifiez uniquement un chemin d’accès au dossier, la commande crée un fichier nommé à cet emplacement.
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 ou comme valeurs possibles pour spécifier la version du catalogue. doit être évité dans la mesure du possible, car il utilise l’algorithme de hachage SHA-1 non sécurisé. La version utilise l’algorithme SHA-256 sécurisé.
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. Lorsque vous spécifiez un dossier, la commande énumère le contenu du dossier de manière récursive pour inclure tous les sous-dossiers et leur contenu. Le fichier catalogue contient des chemins d’accès relatifs aux fichiers inclus dans le catalogue.
Important
Lorsque vous fournissez une liste de fichiers ou de dossiers, l’applet de commande ne peut pas calculer un chemin relatif, car les fichiers et dossiers peuvent se trouver n’importe où sur le système de fichiers. Dans cette condition, l’applet de commande utilise uniquement le nom de fichier pour le hachage, ce qui signifie que vous ne pouvez pas avoir de noms de fichiers en double dans différents chemins d’accès. Pour obtenir les meilleurs résultats, transmettez un dossier unique et laissez l’applet de commande énumérer le contenu. L’applet de commande utilise ce chemin d’accès initial pour calculer les chemins relatifs afin que les noms de fichiers dupliqués soient toujours uniques dans l’arborescence des dossiers.
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 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.
