New-FileCatalog
Vytvoří soubor katalogu Windows obsahující kryptografické hodnoty hash souborů a složek v zadaných cestách.
Syntax
Default (Výchozí)
New-FileCatalog
[-CatalogVersion <Int32>]
[-CatalogFilePath] <String>
[[-Path] <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
rutina This je dostupná jenom na Windows platform.
New-FileCatalog vytvoří soubor katalogu 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
$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 (), který vytváříte. Pokud zadáte pouze cestu ke složce, příkaz v tomto umístění vytvoří soubor s názvem .
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á nebo jako možné hodnoty pro zadání verze katalogu. byste se měli vyhnout, kdykoli je to možné, protože používá nezabezpečený hashovací algoritmus SHA-1. Verze používá zabezpečený algoritmus SHA-256.
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. Když zadáte složku, příkaz vytvoří výčet obsahu složky rekurzivně tak, aby zahrnoval všechny podsložky a jejich obsah. Soubor katalogu obsahuje relativní cesty k souborům zahrnutým v katalogu.
Důležité
Když zadáte seznam souborů nebo složek, rutina nemůže vypočítat relativní cestu, protože soubory a složky můžou být kdekoli v systému souborů. V této podmínce rutina používá pouze název souboru pro hodnotu hash, což znamená, že v různých cestách nemůžete mít duplicitní názvy souborů. Nejlepších výsledků dosáhnete tak, že předáte jednu složku a necháte rutinu vytvořit výčet obsahu. Tato počáteční cesta používá k výpočtu relativních cest, aby duplicitní názvy souborů byly stále jedinečné ve stromu složek.
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 tohoto cmdletu 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 Windows platformách.
