win_unzip – Разархивирует сжатые файлы и архивы на узле Windows
Новая версия 2.0.
Описание
- Разархивирует сжатые файлы и архивы.
- Поддерживает файлы .zip напрямую.
- Поддерживает другие форматы, поддерживаемые модулем PowerShell Community Extensions (PSCX) (по сути, все, что поддерживает 7zip).
- Для целей, отличных от Windows, используйте модуль unarchive вместо этого.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- PSCX
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| creates путь | Если этот файл или каталог существует, указанный src не будет извлечён. | |
| delete_archive логическое значение |
| Удалить файл zip после разархивирования. псевдонимы: rm |
| dest путь / обязательно | Путь назначения для файла zip (укажите абсолютный путь к каталогу). Если он не существует, каталог будет создан. | |
| recurse логическое значение |
| Рекурсивное извлечение сжатых файлов внутри файла src. Установка значения yes требует установки модуля PSCX. |
| src путь / обязательно | Файл для разархивирования (укажите абсолютный путь). |
Примечания
Примечание
- Этот модуль не является полностью идемпотентным, он будет извлекать архив каждый раз и сообщать об изменении.
- Для извлечения типов сжатия, отличных от .zip, требуется модуль PowerShellCommunityExtensions (PSCX). Этот модуль (в сочетании с PSCX) имеет возможность рекурсивного извлечения файлов внутри предоставленного файла zip src, а также функциональность для многих других типов сжатия. Если каталог назначения не существует, он будет создан перед разархивированием файла. Указание параметра rm принудительно удалит файл src после извлечения.
- Для целей, отличных от Windows, используйте модуль unarchive вместо этого.
Примеры
# This unzips a library that was downloaded with win_get_url, and removes the file after extraction
# $ ansible -i hosts -m win_unzip -a "src=C:\LibraryToUnzip.zip dest=C:\Lib remove=true" all
- name: Unzip a bz2 (BZip) file
win_unzip:
src: C:\Users\Phil\Logs.bz2
dest: C:\Users\Phil\OldLogs
creates: C:\Users\Phil\OldLogs
- name: Unzip gz log
win_unzip:
src: C:\Logs\application-error-logs.gz
dest: C:\ExtractedLogs\application-error-logs
# Unzip .zip file, recursively decompresses the contained .gz files and removes all unneeded compressed files after completion.
- name: Unzip ApplicationLogs.zip and decompress all GZipped log files
hosts: all
gather_facts: no
tasks:
- name: Recursively decompress GZ files in ApplicationLogs.zip
win_unzip:
src: C:\Downloads\ApplicationLogs.zip
dest: C:\Application\Logs
recurse: yes
delete_archive: yes
- name: Install PSCX
win_psmodule:
name: Pscx
state: present
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| dest строка | всегда | Указанный путь назначения Пример: C:\ExtractedLogs\application-error-logs |
| removed логическое значение | всегда | Удалил ли модуль какие-либо файлы во время выполнения задачи Пример: True |
| src строка | всегда | Указанный путь источника Пример: C:\Logs\application-error-logs.gz |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Phil Schwartz (@schwartzmx)
Подсказка
Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/win_unzip_module.html
