Sdílet prostřednictvím

New-FileCatalog

  • Reference
Modul:
Microsoft.PowerShell.Security

Vytvoří soubor katalogu Systému Windows obsahující kryptografické hodnoty hash souborů a složek v zadaných cestách.

Syntaxe

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

Description

New-FileCatalog vytvoří 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

$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

Parametry

-CatalogFilePath

Umístění a název souboru katalogu (.cat), který vytváříte. Pokud zadáte pouze cestu ke složce, příkaz v tomto umístění vytvoří soubor s názvem catalog.cat.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-CatalogVersion

Přijímá 1.0 nebo 2.0 co možná hodnoty pro zadání verze katalogu. 1.0 byste se měli vyhnout, kdykoli je to možné, protože používá nezabezpečený hashovací algoritmus SHA-1. Verze 2.0 používá zabezpečený algoritmus SHA-256.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

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

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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, příkaz zahrne všechny soubory ve složce.

Typ:String[]
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Do této rutiny můžete převést ř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.