Udostępnij przez

New-FileCatalog

Moduł:
Microsoft.PowerShell.Security Module

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

Składnia

Default (domyślnie) 

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.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:0
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-CatalogVersion

Akceptuje 1.0 lub 2.0 jako możliwe wartości do określenia wersji katalogu. 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.

Właściwości parametru

Typ:Int32
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:1
Obowiązkowe:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

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.