win_stat - Получение информации о файлах Windows
Новое в версии 1.7.
Описание
- Возвращает информацию о файле Windows.
- Для платформ, отличных от Windows, используйте модуль stat.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| checksum_algorithm (добавлен в 2.3) |
| Алгоритм для определения контрольной суммы файла. Вызовет ошибку, если хост не поддерживает указанный алгоритм. |
| get_checksum bool (добавлен в 2.1) |
| Возвращать ли контрольную сумму файла (по умолчанию sha1). |
| get_md5 bool |
| Возвращать ли контрольную сумму файла в формате MD5. В Ansible 1.9-2.2 это был SHA1, а с Ansible 2.3 - снова MD5. Вернет None, если хост не поддерживает указанный алгоритм. Значение по умолчанию для этого параметра изменилось с yes на no в Ansible 2.5 и будет удалено в Ansible 2.9.Используйте get_checksum=true с checksum_algorithm=md5 для возврата хэша md5 в значении checksum. |
| path обязательно | Полный путь к файлу/объекту, для которого необходимо получить информацию; допускаются как слеши "/", так и обратные слеши "\". |
Примечания
Примечание
- Для платформ, отличных от Windows, используйте модуль stat.
Примеры
- name: Obtain information about a file
win_stat:
path: C:\foo.ini
register: file_info
- name: Obtain information about a folder
win_stat:
path: C:\bar
register: folder_info
- name: Get MD5 checksum of a file
win_stat:
path: C:\foo.ini
get_checksum: yes
checksum_algorithm: md5
register: md5_checksum
- debug:
var: md5_checksum.stat.checksum
- name: Get SHA1 checksum of file
win_stat:
path: C:\foo.ini
get_checksum: yes
register: sha1_checksum
- debug:
var: sha1_checksum.stat.checksum
- name: Get SHA256 checksum of file
win_stat:
path: C:\foo.ini
get_checksum: yes
checksum_algorithm: sha256
register: sha256_checksum
- debug:
var: sha256_checksum.stat.checksum
Возвращаемые значения
Общие возвращаемые значения описаны здесь, а ниже приведены поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| changed boolean | всегда | Указывает, были ли произведены какие-либо изменения Пример: True | |
| stat complex | успех | Словарь, содержащий все данные stat | |
| attributes string | успех, путь существует | Атрибуты файла по пути в сыром виде Пример: Архив, Скрытый | |
| checksum string | успех, путь существует, путь является файлом, get_checksum == True, указанный алгоритм checksum поддерживается | Контрольная сумма файла, основанная на указанном алгоритме checksum_algorithm Пример: 09cb79e8fc7453c84a07f644e441fd81623b7f98 | |
| creationtime float | успех, путь существует | Время создания файла, представленное в секундах с момента эпохи Пример: 1477984205.15 | |
| exists boolean | успех | Существует ли путь или нет Пример: True | |
| extension string | успех, путь существует, путь является файлом | Расширение файла по пути Пример: .ps1 | |
| filename string | успех, путь существует, путь является файлом | Имя файла (без пути) | |
| hlnk_targets list | успех, путь существует | Список других файлов, указывающих на тот же файл (жёсткие ссылки), исключая текущий файл Пример: ['C:\\temp\\file.txt', 'C:\\Windows\\update.log'] | |
| isarchive boolean | успех, путь существует | Можно ли архивировать путь или нет Пример: True | |
| isdir boolean | успех, путь существует | Является ли путь каталогом или нет Пример: True | |
| ishidden boolean | успех, путь существует | Является ли путь скрытым или нет Пример: True | |
| isjunction boolean | успех, путь существует | Является ли путь точкой соединения или нет Пример: True | |
| islnk boolean | успех, путь существует | Является ли путь символической ссылкой или нет Пример: True | |
| isreadonly boolean | успех, путь существует | Является ли путь только для чтения или нет Пример: True | |
| isreg boolean | успех, путь существует | Является ли путь обычным файлом Пример: True | |
| isshared boolean | успех, путь существует | Является ли путь общим или нет Пример: True | |
| lastaccesstime float | успех, путь существует | Время последнего доступа к файлу, представленное в секундах с момента эпохи Пример: 1477984205.15 | |
| lastwritetime float | успех, путь существует | Время последнего изменения файла, представленное в секундах с момента эпохи Пример: 1477984205.15 | |
| lnk_source string | успех, путь существует и путь является символической ссылкой или точкой соединения | Целевой объект symlink, приведенный к нормализованному виду для удалённой файловой системы Пример: C:\temp\link | |
| lnk_target string | успех, путь существует и путь является символической ссылкой или точкой соединения | Целевой объект symlink. Обратите внимание, что относительные пути остаются относительными Пример: ..\link | |
| md5 string | успех, путь существует, путь является файлом, get_md5 == True | Контрольная сумма MD5 файла (между Ansible 1.9 и 2.2 это возвращалась как хеш SHA1), будет удалена в 2.9 Пример: 09cb79e8fc7453c84a07f644e441fd81623b7f98 | |
| nlink int | успех, путь существует | Количество ссылок на файл (жёсткие ссылки) Пример: 1 | |
| owner string | успех, путь существует | Владелец файла Пример: BUILTIN\Administrators | |
| path string | успех, путь существует, файл существует | Полный абсолютный путь к файлу Пример: C:\foo.ini | |
| sharename string | успех, путь существует, файл является каталогом и isshared == True | Имя общего доступа, если папка является общей Пример: file-share | |
| size int | успех, путь существует, файл не является ссылкой | Размер файла или папки в байтах Пример: 1024 | |
Статус
Этот модуль помечен как stableinterface, что означает, что разработчики этого модуля гарантируют, что не будут вноситься несовместимые изменения в интерфейс.
Техническое обслуживание
Этот модуль помечен как core, что означает, что он поддерживается командой Ansible Core. Подробнее см. Техническое обслуживание и поддержка модулей.
Список других модулей, также поддерживаемых командой Ansible Core, см. здесь.
Поддержка
Для получения дополнительной информации о поддержке этого модуля Red Hat, обратитесь к этой статье базы знаний.
Автор
- Крис Черч (@cchurch)
Подсказка
Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/win_stat_module.html
