Freigeben über

New-FileCatalog

Modul:
Microsoft.PowerShell.Security Module

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

Syntax

Default (Standard) 

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.

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 der bzw. in dem die Katalogdatei (.cat) abgelegt werden soll. Wenn ein Ordnerpfad angegeben wird, wird der Standarddateiname catalog.cat verwendet.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-CatalogVersion

Akzeptiert 1.0 oder 2.0 als mögliche Werte für die Angabe der Katalogversion. 1.0 sollte nach Möglichkeit vermieden werden, da es den unsicheren SHA-1-Hash-Algorithmus verwendet, während 2.0 es den sicheren SHA-256-Algorithmus verwendet. 1.0 Dies ist jedoch der einzige unterstützte Algorithmus unter Windows 7 und Server 2008R2.

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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 in diesem Ordner eingeschlossen.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

String

Sie können eine Zeichenfolge, die als Katalogdateiname verwendet wird, über die Pipeline an dieses Cmdlet übergeben.

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.