Dela via

New-FileCatalog

  • Referens
Modul:
Microsoft.PowerShell.Security

Skapar en Windows-katalogfil som innehåller kryptografiska hashvärden för filer och mappar i de angivna sökvägarna.

Syntax

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

Description

Den här cmdleten är endast tillgänglig på Windows-plattformen.

New-FileCatalog skapar en Windows-katalogfil för en uppsättning mappar och filer. Den här katalogfilen innehåller hashvärden för alla filer i de angivna sökvägarna. Användarna kan sedan distribuera katalogen med sina filer så att användarna kan kontrollera om några ändringar har gjorts i mapparna sedan katalogen skapades.

Katalogversionerna 1 och 2 stöds. Version 1 använder (inaktuell) SHA1-hashalgoritmen för att skapa filhashvärden och version 2 använder SHA256.

Exempel

Exempel 1: Skapa en filkatalog för "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

Parametrar

-CatalogFilePath

Platsen och namnet på katalogfilen (.cat) som du skapar. Om du bara anger en mappsökväg skapar kommandot en fil med namnet catalog.cat på den platsen.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-CatalogVersion

Accepterar 1.0 eller 2.0 som möjliga värden för att ange katalogversionen. 1.0 bör undvikas när det är möjligt eftersom den använder den osäkra SHA-1-hashalgoritmen. Version 2.0 använder den säkra SHA-256-algoritmen.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

Accepterar en sökväg eller matris med sökvägar till filer eller mappar som ska ingå i katalogfilen. Om en mapp har angetts innehåller kommandot alla filer i mappen.

Typ:String[]
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

Du kan skicka en sträng som används som katalogfilnamn till den här cmdleten.

Utdata

FileInfo

Den här cmdleten returnerar ett FileInfo- objekt som representerar den skapade katalogen.

Kommentarer

Den här cmdleten är endast tillgänglig på Windows-plattformar.