Dela via

New-FileCatalog

Modul:
Microsoft.PowerShell.Security Module

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

Syntax

Default (Standard) 

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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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.

Parameteregenskaper

Typ:Int32
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Confirm

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:1
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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.