Delen via

New-FileCatalog

  • Referentie
Module:
Microsoft.PowerShell.Security

Hiermee maakt u een Windows-catalogusbestand met cryptografische hashes voor bestanden en mappen in de opgegeven paden.

Syntaxis

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

Description

New-FileCatalog maakt een Windows-catalogusbestand voor een set mappen en bestanden. Dit catalogusbestand bevat hashes voor alle bestanden in de opgegeven paden. Gebruikers kunnen de catalogus vervolgens distribueren met hun bestanden, zodat gebruikers kunnen valideren of er wijzigingen zijn aangebracht in de mappen sinds het maken van de catalogus.

Catalogusversie 1 en 2 worden ondersteund. Versie 1 maakt gebruik van het sha1-hash-algoritme (afgeschaft) om bestandshashes te maken en versie 2 maakt gebruik van SHA256.

Voorbeelden

Voorbeeld 1: Een bestandscatalogus maken voor 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

Parameters

-CatalogFilePath

De locatie en naam van het catalogusbestand (.cat) dat u maakt. Als u alleen een mappad opgeeft, maakt de opdracht een bestand met de naam catalog.cat op die locatie.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-CatalogVersion

1.0 Accepteert of 2.0 indien mogelijk waarden voor het opgeven van de catalogusversie. 1.0 moet waar mogelijk worden vermeden omdat het gebruik maakt van het onveilige SHA-1-hash-algoritme. De versie 2.0 maakt gebruik van het beveiligde SHA-256-algoritme.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Path

Accepteert een pad of matrix van paden naar bestanden of mappen die moeten worden opgenomen in het catalogusbestand. Als er een map is opgegeven, bevat de opdracht alle bestanden in de map.

Type:String[]
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

U kunt een tekenreeks doorsluisen die wordt gebruikt als de bestandsnaam van de catalogus naar deze cmdlet.

Uitvoerwaarden

FileInfo

Deze cmdlet retourneert een FileInfo-object dat de gemaakte catalogus vertegenwoordigt.