Archive

Статья
05/05/2023

Краткий обзор

Разверните или удалите содержимое архивного (.zip) файла.

Синтаксис

Archive [String] #ResourceName
{
    Destination = [string]
    Path = [string]
    [Checksum = [string]{ CreatedDate | ModifiedDate | SHA-1 | SHA-256 | SHA-512 }]
    [Credential = [PSCredential]]
    [DependsOn = [string[]]]
    [Ensure = [string]{ Absent | Present }]
    [Force = [bool]]
    [PsDscRunAsCredential = [PSCredential]]
    [Validate = [bool]]
}

Описание

Ресурс Archive позволяет идемпотентно управлять развернутым содержимым архивного (.zip) файла. Он может гарантировать, что развернутое содержимое архива обновлено или удалено из системы.

Требования

Сборка типа System.IO.Compression должна быть доступна на компьютере.
Сборка типа System.IO.Compression.FileSystem должна быть доступна на компьютере.

свойства ключа;

Назначение

Укажите путь к папке, в который должно быть записано или удалено развернутое содержимое.

Type: System.String

Path

Укажите путь к файлу архива.

Type: System.String

Необязательные свойства

Контрольная сумма

Укажите метод контрольной суммы, используемый при проверке развернутого содержимого в архиве. Если указать значение контрольной суммы и проверить как $false, ресурс создает исключение недопустимого аргумента.

Если указать "Проверить как $true", значение по умолчанию для контрольной суммы равно ModifiedDate.

Примечание

Использование контрольной суммы или проверки подразумевает другое. Несмотря на то, что вы можете указать "Проверить без контрольной суммы", рекомендуется указать оба варианта вместе.

Указанный метод определяет, как ресурс проверяет развернутое содержимое в архиве:

При этом ModifiedDateресурс проверяет, соответствует ли свойство LastWriteTime каждого развернутого файла свойству LastWriteTime этого файла в архиве.
При использовании CreatedDateресурса проверяется, соответствует ли свойство CreationTime каждого развернутого файла свойству CreationTime этого файла в архиве.
SHA-256 SHA-512Если SHA-1ресурс использует указанный метод SHA для проверки хэша каждого развернутого файла по хэшу этого файла в архиве.

Type: System.String
Accepted Values:
  - ModifiedDate
  - CreatedDate
  - SHA-1
  - SHA-256
  - SHA-512
Default Value: ModifiedDate

Учетные данные

При необходимости укажите учетные данные учетной записи пользователя с разрешениями на доступ к указанному пути и назначению .

Type: System.Management.Automation.PSCredential
Default Value: None

Ensure

Укажите, должно ли существовать развернутое содержимое архивного файла. Чтобы развернуть архив, укажите это свойство как Present. Чтобы удалить развернутое содержимое архива, укажите это свойство как Absent. Значение по умолчанию — Present.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

Force

Укажите, следует ли перезаписать существующее содержимое в назначении. Если параметр Force имеет значение $falseForce, ресурс ошибается, если элемент в месте назначения должен быть перезаписан. Значение по умолчанию — $false.

Type: System.Boolean
Default Value: false

Проверить

Укажите, следует ли проверять развернутое содержимое указанным методом контрольной суммы. Значение по умолчанию — $false.

Если проверка и $true файл в месте назначения не совпадает с файлом в архиве:

Если задано значение "Проверка" Present и "$falseПринудительно", ошибки ресурса с сообщением о том, что файл в месте назначения не может быть перезаписан.
Если задано значение "Проверка" Present и "$trueПринудительно", ресурс перезаписывает файл.
Если убедитесьAbsent, что ресурс не удаляет файл.

Type: System.Boolean
Default Value: false

Поделиться через