Share via

New-FileCatalog

Module:
Microsoft.PowerShell.Security Module

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

Syntax

Default (Standaard) 

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

Description

Deze cmdlet is alleen beschikbaar op het Windows platform.

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 () die u maakt. Als u alleen een mappad opgeeft, maakt de opdracht een bestand met de naam op die locatie.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-CatalogVersion

Accepteert of mogelijk waarden voor het opgeven van de catalogusversie. moet waar mogelijk worden vermeden omdat er gebruik wordt gemaakt van het onveilige SHA-1-hash-algoritme. Versie maakt gebruik van het beveiligde SHA-256-algoritme.

Parametereigenschappen

Type:Int32
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Path

Accepteert een pad of matrix van paden naar bestanden of mappen die moeten worden opgenomen in het catalogusbestand. Wanneer u een map opgeeft, wordt met de opdracht de inhoud van de map recursief opgesomd om alle submappen en de bijbehorende inhoud op te nemen. Het catalogusbestand bevat relatieve paden naar de bestanden die in de catalogus zijn opgenomen.

Belangrijk

Wanneer u een lijst met bestanden of mappen opgeeft, kan de cmdlet geen relatief pad berekenen, omdat de bestanden en mappen zich overal in het bestandssysteem kunnen bevinden. Onder deze voorwaarde gebruikt de cmdlet alleen de bestandsnaam voor de hash, wat betekent dat u geen dubbele bestandsnamen in verschillende paden kunt hebben. Geef voor de beste resultaten één map door en laat de cmdlet de inhoud opsommen. De cmdlet gebruikt dat eerste pad om relatieve paden te berekenen, zodat dubbele bestandsnamen nog steeds uniek zijn binnen de mapstructuur.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:1
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

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

Uitvoerwaarden

FileInfo

Met deze cmdlet wordt een FileInfo--object geretourneerd dat de gemaakte catalogus vertegenwoordigt.

Notities

Deze cmdlet is alleen beschikbaar op Windows platforms.