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 строка	Варианты: md5 sha1 ← sha256 sha384 sha512	Алгоритм для определения контрольной суммы файла. Вызовет ошибку, если хост не может использовать указанный алгоритм.
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 булево		всегда	Изменилось ли что-либо Пример: Истина
stat сложный		успех	Словарь, содержащий все данные stat
	attributes строка	успех, путь существует	Атрибуты файла в пути в сыром виде. Пример: Архивный, Скрытый
	checksum строка	успех, путь существует, путь является файлом, get_checksum == True алгоритм checksum_algorithm поддерживается	Контрольная сумма файла, основанная на указанном checksum_algorithm. Пример: 09cb79e8fc7453c84a07f644e441fd81623b7f98
	creationtime вещественное число	успех, путь существует	Время создания файла, представленное в секундах с начала эпохи. Пример: 1477984205.15
	exists булево	успех	Существует ли путь или нет. Пример: Истина
	extension строка	успех, путь существует, путь является файлом	Расширение файла в пути. Пример: .ps1
	filename строка	успех, путь существует, путь является файлом	Имя файла (без пути). Пример: foo.ini
	hlnk_targets список / элементы=строка	успех, путь существует	Список других файлов, ссылающихся на тот же файл (жесткие ссылки), исключая текущий файл. Пример: ['C:\\temp\\file.txt', 'C:\\Windows\\update.log']
	isarchive булево	успех, путь существует	Готов ли путь к архивированию или нет. Пример: Истина
	isdir булево	успех, путь существует	Является ли путь каталогом или нет. Пример: Истина
	ishidden булево	успех, путь существует	Скрыт ли путь или нет. Пример: Истина
	isjunction булево	успех, путь существует	Является ли путь точкой сопряжения или нет. Пример: Истина
	islnk булево	успех, путь существует	Является ли путь символичной ссылкой или нет. Пример: Истина
	isreadonly булево	успех, путь существует	Является ли путь только для чтения или нет. Пример: Истина
	isreg булево	успех, путь существует	Является ли путь обычным файлом. Пример: Истина
	isshared булево	успех, путь существует	Поделен ли путь или нет. Пример: Истина
	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 == Истина	Имя общей папки, если папка общая. Пример: file-share
	size целое число	успех, путь существует, файл не является ссылкой	Размер файла или папки в байтах. Пример: 1024

Авторы

Chris Church (@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.10/collections/ansible/windows/win_stat_module.html