ansible.windows.win_stat – Получение информации о файлах Windows
Примечание
Этот плагин является частью коллекции ansible.windows (версия 1.3.0).
Для его установки используйте: ansible-galaxy collection install ansible.windows.
Для использования в плейбуке укажите: ansible.windows.win_stat.
Описание
- Возвращает информацию о файле Windows.
- Для не-Windows целей используйте модуль ansible.builtin.stat вместо него.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| checksum_algorithm строка |
| Алгоритм определения контрольной суммы файла. Вызовет ошибку, если хост не может использовать указанный алгоритм. |
| follow логическое |
| Следовать ли ссылкам или узлам соединения. В случае, если path указывает на другую ссылку, то она будет следовать, пока не будут найдены больше ссылок. |
| get_checksum логическое |
| Возвращать ли контрольную сумму файла (по умолчанию sha1) |
| path путь / обязательно | Полный путь к файлу/объекту, для получения фактов; допускаются как прямые, так и обратные слеши. псевдонимы: dest, name |
См. также
См. также
- ansible.builtin.stat
-
Официальная документация модуля ansible.builtin.stat.
- ansible.windows.win_acl
-
Официальная документация модуля ansible.windows.win_acl.
- ansible.windows.win_file
-
Официальная документация модуля ansible.windows.win_file.
- ansible.windows.win_owner
-
Официальная документация модуля ansible.windows.win_owner.
Примеры
- name: Obtain information about a file
ansible.windows.win_stat:
path: C:\foo.ini
register: file_info
- name: Obtain information about a folder
ansible.windows.win_stat:
path: C:\bar
register: folder_info
- name: Get MD5 checksum of a file
ansible.windows.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
ansible.windows.win_stat:
path: C:\foo.ini
get_checksum: yes
register: sha1_checksum
- debug:
var: sha1_checksum.stat.checksum
- name: Get SHA256 checksum of file
ansible.windows.win_stat:
path: C:\foo.ini
get_checksum: yes
checksum_algorithm: sha256
register: sha256_checksum
- debug:
var: sha256_checksum.stat.checksum
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| changed логическое | всегда | Изменилось ли что-либо Пример: True | |
| stat сложное | успех | Словарь, содержащий все данные stat | |
| attributes строка | успех, путь существует | Атрибуты файла по пути в сыром виде. Пример: Архив, Скрытый | |
| checksum строка | успех, путь существует, путь — файл, get_checksum == True, указанный checksum_algorithm поддерживается | Контрольная сумма файла, основанная на указанном checksum_algorithm. Пример: 09cb79e8fc7453c84a07f644e441fd81623b7f98 | |
| creationtime число с плавающей точкой | успех, путь существует | Время создания файла, представленное в секундах с начала эпохи. Пример: 1477984205.15 | |
| exists логическое | успех | Существует ли путь или нет. Пример: True | |
| extension строка | успех, путь существует, путь — файл | Расширение файла по пути. Пример: .ps1 | |
| filename строка | успех, путь существует, путь — файл | Имя файла (без пути). Пример: foo.ini | |
| hlnk_targets список / элементы=строка | успех, путь существует | Список других файлов, указывающих на тот же файл (жёсткие ссылки), исключая текущий файл. Пример: ['C:\\temp\\file.txt', 'C:\\Windows\\update.log'] | |
| isarchive логическое | успех, путь существует | Готов ли путь к архивированию или нет. Пример: True | |
| isdir логическое | успех, путь существует | Является ли путь каталогом или нет. Пример: True | |
| ishidden логическое | успех, путь существует | Является ли путь скрытым или нет. Пример: True | |
| isjunction логическое | успех, путь существует | Является ли путь точкой соединения или нет. Пример: True | |
| islnk логическое | успех, путь существует | Является ли путь символической ссылкой или нет. Пример: True | |
| isreadonly логическое | успех, путь существует | Только чтение или нет. Пример: True | |
| isreg логическое | успех, путь существует | Регулярный файл или нет. Пример: True | |
| isshared логическое | успех, путь существует | Поделиться или нет. Пример: True | |
| lastaccesstime число с плавающей точкой | успех, путь существует | Время последнего доступа к файлу в секундах с начала эпохи. Пример: 1477984205.15 | |
| lastwritetime число с плавающей точкой | успех, путь существует | Время последнего изменения файла в секундах с начала эпохи. Пример: 1477984205.15 | |
| lnk_source строка | успех, путь существует и путь — символическая ссылка или точка соединения | Целевой путь символической ссылки, нормализованный для удалённой файловой системы. Пример: C:\temp\link | |
| lnk_target строка | успех, путь существует и путь — символическая ссылка или точка соединения | Целевой путь символической ссылки. Отдельные пути остаются относительными. Пример: ..\link | |
| nlink целое число | успех, путь существует | Количество ссылок на файл (жёсткие ссылки). Пример: 1 | |
| owner строка | успех, путь существует | Владелец файла. Пример: BUILTIN\Administrators | |
| path строка | успех, путь существует, файл существует | Полный абсолютный путь к файлу. Пример: C:\foo.ini | |
| sharename строка | успех, путь существует, файл — каталог и isshared == True | Имя общего доступа, если папка доступна в общем доступе. Пример: file-share | |
| size целое число | успех, путь существует, файл не ссылка | Размер файла в байтах или каталога. Пример: 1024 | |
Авторы
- Chris Church (@cchurch)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/windows/win_stat_module.html
