New-FileCatalog
New-FileCatalog tworzy plik wykazu skrótów plików, których można użyć do zweryfikowania autentyczności pliku.
Składnia
Default (domyślnie)
New-FileCatalog
[-CatalogVersion <Int32>]
[-CatalogFilePath] <String>
[[-Path] <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Ten cmdlet jest dostępny 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"
New-FileCatalog -Path $PSHOME\Modules\Microsoft.PowerShell.Utility -CatalogFilePath \temp\Microsoft.PowerShell.Utility.cat -CatalogVersion 2.0
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 11/2/2018 11:58 AM 950 Microsoft.PowerShell.Utility.cat
Parametry
-CatalogFilePath
Ścieżka do pliku lub folderu, w którym powinien zostać umieszczony plik katalogu (cat). Jeśli zostanie określona ścieżka folderu, zostanie użyta domyślna nazwa catalog.cat pliku.
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 go unikać, gdy tylko jest to możliwe, ponieważ używa niezabezpieczonego algorytmu skrótu SHA-1, podczas gdy 2.0 używa bezpiecznego algorytmu SHA-256 Jest to jednak 1.0 jedyny obsługiwany algorytm w systemach Windows 7 i Server 2008R2.
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 folder zostanie określony, wszystkie pliki w folderze również zostaną uwzględnione.
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żna przesłać ciąg, który jest używany jako nazwa pliku katalogu.
Dane wyjściowe
FileInfo
To polecenie cmdlet zwraca obiekt FileInfo reprezentujący utworzony wykaz.
Uwagi
Ten cmdlet jest dostępny tylko na platformach Windows.