New-FileCatalog
Tworzy plik wykazu 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
polecenie cmdlet This jest dostępne tylko w Windows platform.
New-FileCatalog tworzy plik katalogu 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.
Ważna
Wykazy oparte na algorytmie SHA1 są przestarzałe i nie powinny być zaufane w przypadku przepływów pracy z uwzględnieniem zabezpieczeń.
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
1.0 Akceptuje lub 2.0 jak to możliwe wartości do określania wersji wykazu. Wersja 2.0 używa bezpiecznego algorytmu SHA-256.
Ważna
Wykazy w wersji 1.0 (oparte na algorytmie SHA1) są przestarzałe i nie powinny być zaufane w przypadku przepływów pracy z uwzględnieniem zabezpieczeń.
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. Po określeniu folderu polecenie wylicza zawartość folderu rekursywnie w celu uwzględnienia wszystkich podfolderów i ich zawartości. Plik wykazu zawiera ścieżki względne do plików zawartych w wykazie.
Ważna
Po podaniu listy plików lub folderów polecenie cmdlet nie może obliczyć ścieżki względnej, ponieważ pliki i foldery mogą znajdować się w dowolnym miejscu w systemie plików. W tym warunku polecenie cmdlet używa tylko nazwy pliku skrótu, co oznacza, że nie można mieć zduplikowanych nazw plików w różnych ścieżkach. Aby uzyskać najlepsze wyniki, przekaż pojedynczy folder i pozwól, aby polecenie cmdlet wyliczało zawartość. Polecenie cmdlet używa tej początkowej ścieżki do obliczania ścieżek względnych, tak aby zduplikowane nazwy plików nadal są unikatowe w drzewie folderów.
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.
Notatki
To polecenie cmdlet jest dostępne tylko na platformach Windows.
