Freigeben über

New-FileCatalog

  • Referenz
Modul:
Microsoft.PowerShell.Security

Erstellt eine Windows-Katalogdatei, die kryptografische Hashes für Dateien und Ordner in den angegebenen Pfaden enthält.

Syntax

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

Beschreibung

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

New-FileCatalog erstellt eine Windows-Katalogdatei für eine Reihe von Ordnern und Dateien. Diese Katalogdatei enthält Hashes für alle Dateien in den bereitgestellten Pfaden. Benutzer können den Katalog dann mit ihren Dateien verteilen, damit Benutzer überprüfen können, ob seit der Katalogerstellung Änderungen an den Ordnern vorgenommen wurden.

Die Katalogversionen 1 und 2 werden unterstützt. Version 1 verwendet den (veralteten) SHA1-Hashingalgorithmus zum Erstellen von Dateihashes, und Version 2 verwendet SHA256.

Beispiele

Beispiel 1: Erstellen eines Dateikatalogs für "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

Parameter

-CatalogFilePath

Der Speicherort und der Name der Katalogdatei (.cat), die Sie erstellen. Wenn Sie nur einen Ordnerpfad angeben, erstellt der Befehl eine Datei mit dem Namen catalog.cat an diesem Speicherort.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CatalogVersion

Akzeptiert 1.0 oder 2.0 wie möglich Werte für die Angabe der Katalogversion. 1.0 sollte möglichst vermieden werden, da der unsichere SHA-1-Hashalgorithmus verwendet wird. Version 2.0 verwendet den sicheren SHA-256-Algorithmus.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Akzeptiert einen Pfad oder ein Array von Pfaden zu Dateien oder Ordnern, die in die Katalogdatei eingeschlossen werden sollen. Wenn ein Ordner angegeben ist, enthält der Befehl alle Dateien im Ordner.

Type:String[]
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

String

Sie können eine Zeichenfolge, die als Katalogdateiname verwendet wird, an dieses Cmdlet weiterleiten.

Ausgaben

FileInfo

Dieses Cmdlet gibt ein FileInfo-Objekt zurück, das den erstellten Katalog darstellt.

Hinweise

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.