Delen 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.

Syntaxis

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 (.cat) die u maakt. Als u alleen een mappad opgeeft, maakt de opdracht een bestand met de naam catalog.cat 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 1.0 of 2.0 mogelijk waarden voor het opgeven van de catalogusversie. 1.0 moet waar mogelijk worden vermeden omdat er gebruik wordt gemaakt van het onveilige SHA-1-hash-algoritme. Versie 2.0 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. Als er een map is opgegeven, bevat de opdracht alle bestanden in de map.

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.