community.windows.win_zip 模块 – 在 Windows 节点上将文件或目录压缩为 zip 存档
注意
此模块是 community.windows 集合 (版本 2.3.0) 的一部分。
如果您使用的是 ansible
包,则可能已安装此集合。它不包含在 ansible-core
中。要检查是否已安装它,请运行 ansible-galaxy collection list
。
要安装它,请使用:ansible-galaxy collection install community.windows
。您需要其他要求才能使用此模块,请参阅 需求 了解详细信息。
要在 playbook 中使用它,请指定:community.windows.win_zip
。
概要
将文件或目录压缩为 zip 存档。
对于非 Windows 目标,请改用 community.general.archive 模块。
需求
执行此模块的主机需要以下需求。
.NET Framework 4.5 或更高版本
参数
参数 |
注释 |
---|---|
zip 文件的目标路径(在目标节点上提供 zip 文件的绝对路径)。 |
|
要压缩的文件或目录路径(在目标节点上提供绝对路径)。 当目录路径时,目录将作为存档中的根条目进行压缩。 将 |
注释
注意
zip 中的文件名使用 UTF-8 编码。
另请参阅
另请参阅
- community.general.archive
创建一到多个文件或树的压缩存档。
示例
- name: Compress a file
community.windows.win_zip:
src: C:\Users\hiyoko\log.txt
dest: C:\Users\hiyoko\log.zip
- name: Compress a directory as the root of the archive
community.windows.win_zip:
src: C:\Users\hiyoko\log
dest: C:\Users\hiyoko\log.zip
- name: Compress the directories contents
community.windows.win_zip:
src: C:\Users\hiyoko\log\*
dest: C:\Users\hiyoko\log.zip