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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CatalogVersion

1.0 Accepterar 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. Versionen 2.0 använder den säkra SHA-256-algoritmen.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.