New-FileCatalog

  • Reference
Modul:
Microsoft.PowerShell.Security

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

Syntax

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

Description

Tato rutina je dostupná jenom na platformě Windows.

New-FileCatalogvytvoří soubor katalogu Systému Windows pro sadu složek a souborů. Tento soubor katalogu 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á algoritmus hash SHA1 SHA1 (zastaralý) k vytvoření hodnot hash souborů a verze 2 používá ALGORITMUS 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, kam by se měl umístit soubor katalogu (.cat). Pokud je zadána cesta ke složce, použije se výchozí název souboru catalog.cat .

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

-CatalogVersion

Přijímá 1.0 nebo 2.0 je možné zadat verzi katalogu. 1.0 by se mělo používat, kdykoli je to možné, protože používá nezabezpečený hashovací algoritmus SHA-1, zatímco 2.0 používá zabezpečený algoritmus SHA-256, 1.0 je však jediným podporovaným algoritmem ve Windows 7 a Serveru 2008R2.

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 zadaná složka, budou zahrnuty i všechny soubory ve složce.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

String

Do této rutiny můžete zamísťovat ř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

Tato rutina je dostupná jenom na platformách Windows.