New-FileCatalog
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. Katalogversion 2 wird unter Windows Server 2008 R2 oder Windows 7 nicht unterstützt. Sie sollten die Katalogversion 2 unter Windows 8, Windows Server 2012 und höher verwenden.
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
Die Pipeline verwendet eine Zeichenfolge, die als Katalogdateiname verwendet wird.
Ausgaben
FileInfo
Hinweise
Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.