Sdílet prostřednictvím

New-FileCatalog

Modul:
Microsoft.PowerShell.Security Module

New-FileCatalog vytvoří soubor katalogu hodnot hash souborů, které lze použít k ověření pravosti souboru.

Syntax

Default (Výchozí) 

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

Description

Tato rutina je dostupná jenom na platformě Windows.

New-FileCatalog vytvoří soubor katalogu systému Windows pro sadu složek a souborů. Tento katalogový soubor obsahuje hodnoty hash pro všechny soubory v zadaných cestách. Uživatelé pak můžou katalog distribuovat se svými soubory, aby uživatelé mohli ověřit, jestli se od doby vytvoření katalogu provedly nějaké změny ve složkách.

Podporují se verze katalogu 1 a 2. Verze 1 používá zastaralý algoritmus hashování SHA1 k vytvoření hodnot hash souborů, zatímco verze 2 používá SHA256.

Příklady

Příklad 1: Vytvoření katalogu souborů pro Microsoft.PowerShell.Utility

New-FileCatalog -Path $PSHOME\Modules\Microsoft.PowerShell.Utility -CatalogFilePath \temp\Microsoft.PowerShell.Utility.cat -CatalogVersion 2.0

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         11/2/2018 11:58 AM            950 Microsoft.PowerShell.Utility.cat

Parametry

-CatalogFilePath

Cesta k souboru nebo složce, do které by měl být umístěn soubor katalogu (.cat). Pokud je zadána cesta ke složce, použije se výchozí název catalog.cat souboru.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:0
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-CatalogVersion

Přijímá 1.0 nebo 2.0 jako možné hodnoty pro zadání verze katalogu. 1.0 by se mělo používat vždy, když je to možné, protože používá nezabezpečený algoritmus hash SHA-1, zatímco 2.0 používá zabezpečený algoritmus SHA-256 Je však 1.0 jediným podporovaným algoritmem v systémech Windows 7 a Server 2008R2.

Vlastnosti parametru

Typ:Int32
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Path

Přijímá cestu nebo pole cest k souborům nebo složkám, které by měly být zahrnuty do souboru katalogu. Pokud je zadána složka, budou zahrnuty také všechny soubory v této složce.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:1
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

Do této rutiny můžete předat řetězec, který se používá jako název souboru katalogu.

Výstupy

FileInfo

Tato rutina vrátí objekt FileInfo představující vytvořený katalog.

Poznámky

Tento cmdlet je dostupný pouze na platformách Windows.