Udostępnij za pośrednictwem

New-FileCatalog

  • Odwołanie
Moduł:
Microsoft.PowerShell.Security

Tworzy plik wykazu systemu Windows zawierający skróty kryptograficzne plików i folderów w określonych ścieżkach.

Składnia

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

Opis

New-FileCatalog Tworzy plik wykazu systemu Windows dla zestawu folderów i plików. Ten plik wykazu zawiera skróty dla wszystkich plików w podanych ścieżkach. Użytkownicy mogą następnie rozpowszechniać katalog przy użyciu swoich plików, aby użytkownicy mogli sprawdzić, czy jakiekolwiek zmiany zostały wprowadzone do folderów od czasu utworzenia wykazu.

Obsługiwane są wersje wykazu 1 i 2. Wersja 1 używa algorytmu wyznaczania wartości skrótu SHA1 (przestarzałego) do tworzenia skrótów plików, a wersja 2 używa algorytmu SHA256.

Przykłady

Przykład 1. Tworzenie katalogu plików dla programu "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

Lokalizacja i nazwa tworzonego pliku wykazu (.cat). Jeśli określisz tylko ścieżkę folderu, polecenie utworzy plik o nazwie catalog.cat w tej lokalizacji.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-CatalogVersion

1.0 Akceptuje lub 2.0 jak to możliwe wartości do określania wersji wykazu. 1.0 należy unikać zawsze, gdy jest to możliwe, ponieważ używa niezabezpieczonego algorytmu wyznaczania wartości skrótu SHA-1. Wersja 2.0 używa bezpiecznego algorytmu SHA-256.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Path

Akceptuje ścieżkę lub tablicę ścieżek do plików lub folderów, które powinny być zawarte w pliku wykazu. Jeśli zostanie określony folder, polecenie zawiera wszystkie pliki w folderze.

Typ:String[]
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Do tego polecenia cmdlet możesz przekazać ciąg, który jest używany jako nazwa pliku wykazu.

Dane wyjściowe

FileInfo

To polecenie cmdlet zwraca obiekt FileInfo reprezentujący utworzony wykaz.