Share via

New-FileCatalog

  • Referenz
Modul:
Microsoft.PowerShell.Security

New-FileCatalog erstellt eine Katalogdatei mit Dateihashes, die verwendet werden können, um die Authentizität einer Datei zu überprüfen.

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 dann den Katalog 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, um Dateihashes zu erstellen, und Version 2 verwendet SHA256. Katalogversion 2 wird weder auf Windows Server 2008 R2 noch auf Windows 7 unterstützt. Daher sollten Sie die Katalogversion 2 mit Windows 8, Windows Server 2012 und späteren Betriebssystemen verwenden.

Beispiele

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

Parameter

-CatalogFilePath

Ein Pfad zu einer Datei oder einem Ordner, in dem die Katalogdatei (.cat) platziert werden soll. Wenn ein Ordnerpfad angegeben wird, wird der Standarddateiname catalog.cat verwendet.

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

-CatalogVersion

Akzeptiert 1.0 oder 2.0 als mögliche Werte für die Angabe der Katalogversion. 1.0 sollte möglichst vermieden werden, da der unsichere SHA-1-Hashalgorithmus verwendet wird, während 2.0 der sichere SHA-256-Algorithmus verwendet wird. 1.0 Es ist jedoch der einzige unterstützte Algorithmus unter Windows 7 und Server 2008R2.

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 der Katalogdatei enthalten sein sollen. Wenn ein Ordner angegeben wird, werden auch alle Dateien im Ordner eingeschlossen.

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

Die Pipeline verwendet eine Zeichenfolge, die als Katalogdateiname verwendet wird.

Ausgaben

FileInfo

Hinweise

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