ansible / ansible.builtin / v2.4.2.0-1 / module / win_unzip Unzips compressed files and archives on the Windows node | "added in version" 2.0 of ansible.builtin" Authors: Phil Schwartz (@schwartzmx) preview | supported by communityansible.builtin.win_unzip (v2.4.2.0-1) — module
pip
Install with pip install ansible==2.4.2.0.post1
Unzips compressed files and archives.
Supports .zip files natively
Supports other formats supported by the Powershell Community Extensions (PSCX) module (basically everything 7zip supports)
For non-Windows targets, use the M(unarchive) module instead.
# 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: false 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
# Install PSCX to use for extracting a gz file - name: Grab PSCX msi win_get_url: url: http://download-codeplex.sec.s-msft.com/Download/Release?ProjectName=pscx&DownloadId=923562&FileTime=130585918034470000&Build=20959 dest: C:\Windows\Temp\pscx.msi
- name: Install PSCX win_msi: path: C:\Windows\Temp\pscx.msi
src: description: - File to be unzipped (provide absolute path). required: true dest: description: - Destination of zip file (provide absolute path of directory). If it does not exist, the directory will be created. required: true creates: description: - If this file or directory exists the specified src will not be extracted. recurse: default: 'no' description: - Recursively expand zipped files within the src file. type: bool delete_archive: aliases: - rm default: 'no' description: - Remove the zip file, after unzipping. type: bool
dest: description: The provided destination path returned: always sample: C:\ExtractedLogs\application-error-logs type: string removed: description: Whether the module did remove any files during task run returned: always sample: true type: boolean src: description: The provided source path returned: always sample: C:\Logs\application-error-logs.gz type: string