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

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

$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 vytvoří v tomto umístění 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 je možné zadat verzi katalogu. 1.0 by se mělo 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 zobrazí výzvu 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

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

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.

Poznámky

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