New-FileCatalog

  • Referenz
Modul:
Microsoft.PowerShell.Security

New-FileCatalog erstellt eine Katalogdatei mit Dateihashes, die verwendet werden kann, 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 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"

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) abgelegt werden soll. Wenn ein Ordnerpfad angegeben ist, 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 wie möglich Werte für die Angabe der Katalogversion. 1.0 sollte nach Möglichkeit vermieden werden, da der unsichere SHA-1-Hashalgorithmus verwendet wird, während 2.0 der sichere SHA-256-Algorithmus verwendet wird. 1.0 Dies 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 die Katalogdatei eingeschlossen werden sollen. Wenn ein Ordner angegeben ist, 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

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

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.