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

To polecenie cmdlet jest dostępne tylko na platformie Windows.

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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Uwagi

To polecenie cmdlet jest dostępne tylko na platformach windows.