New-FileCatalog
Создает файл каталога #REF!, содержащий криптографические хэши для файлов и папок в указанных путях.
Синтаксис
Default (По умолчанию)
New-FileCatalog
[-CatalogVersion <Int32>]
[-CatalogFilePath] <String>
[[-Path] <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
New-FileCatalog создает файл каталога #REF! для набора папок и файлов. Этот файл каталога содержит хэши для всех файлов в предоставленных путях. Затем пользователи могут распространять каталог со своими файлами, чтобы пользователи могли проверить, были ли внесенные изменения в папки с момента создания каталога.
Поддерживаются версии каталога 1 и 2. Версия 1 использует алгоритм хэширования SHA1 (не рекомендуется) для создания хэшей файлов, а версия 2 использует SHA256.
Примеры
Пример 1. Создание каталога файлов для 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
Параметры
-CatalogFilePath
Расположение и имя создаваемого файла каталога (). Если указать только путь к папке, команда создает файл с именем в этом расположении.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-CatalogVersion
Принимает или в качестве возможных значений для указания версии каталога. следует избегать по возможности, так как он использует небезопасный хэш-алгоритм SHA-1. В версии используется безопасный алгоритм SHA-256.
Свойства параметров
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Path
Принимает путь или массив путей к файлам или папкам, которые должны быть включены в файл каталога. При указании папки команда перечисляет содержимое папки рекурсивно, чтобы включить все вложенные папки и их содержимое. Файл каталога содержит относительные пути к файлам, включенным в каталог.
Это важно
При предоставлении списка файлов или папок командлет не может вычислить относительный путь, так как файлы и папки могут находиться в любом месте файловой системы. В этом условии командлет использует только имя файла для хэша, что означает, что в разных путях не может быть повторяющихся имен файлов. Для получения наилучших результатов передайте в одну папку и позвольте командлету перечислить содержимое. Командлет использует этот начальный путь для вычисления относительных путей, чтобы повторяющиеся имена файлов по-прежнему уникальны в дереве папок.
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
String
Вы можете перенаправить строку, используемую в качестве имени файла каталога, в этот командлет.
Выходные данные
FileInfo
Этот командлет возвращает объект FileInfo, представляющий созданный каталог.
