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.
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 (). Jeśli określisz tylko ścieżkę folderu, polecenie utworzy plik o nazwie 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 lub jako możliwe wartości do określenia wersji katalogu. należy unikać zawsze, gdy jest to możliwe, ponieważ używa niezabezpieczonego algorytmu wyznaczania wartości skrótu SHA-1. Wersja 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. 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.
