win_stat - возвращает информацию о файле Windows
Новое в версии 1.7.
Описание
- Возвращает информацию о файле Windows.
- Для платформ, отличных от Windows, используйте модуль stat вместо этого.
Параметры
| Параметр | Обязательно | По умолчанию | Варианты | Комментарии |
|---|---|---|---|---|
| checksum_algorithm (добавлен в 2.3)
| нет | sha1 |
| Алгоритм для определения контрольной суммы файла. Вызовет ошибку, если хост не поддерживает указанный алгоритм. |
| get_checksum (добавлен в 2.1)
| нет | True | Возвращать ли контрольную сумму файла (по умолчанию sha1) | |
| get_md5 | нет | True | Возвращать ли контрольную сумму файла. В Ansible 1.9-2.2 это был SHA1, а с Ansible 2.3 снова MD5. Вернет None, если хост не поддерживает указанный алгоритм. Этот параметр устарел в Ansible 2.3 и заменён на checksum_algorithm=md5. | |
| path | да | Полный путь к файлу/объекту, для которого требуется получить информацию; допускаются как прямые, так и обратные слэши. |
Примеры
- name: Obtain information about a file
win_stat:
path: C:\foo.ini
register: file_info
# Obtain information about a folder
- win_stat:
path: C:\bar
register: folder_info
# 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
# Get SHA1 checksum of file
- win_stat:
path: C:\foo.ini
get_checksum: yes
register: sha1_checksum
- debug:
var: sha1_checksum.stat.checksum
# 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 | Словарь, содержащий все данные stat | успех | сложный | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| содержит: |
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Примечания
Примечание
- Для платформ, отличных от Windows, используйте модуль stat вместо этого.
Статус
Этот модуль помечен как stableinterface, что означает, что разработчики гарантируют отсутствие несовместимых изменений интерфейса.
Информация о поддержке
Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>.
Для получения помощи в разработке модулей см. Информацию о сообществе и участии, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/win_stat_module.html
