win_robocopy - Синхронизирует содержимое двух каталогов с помощью Robocopy

Новое в версии 2.2.

Описание
Параметры
Примеры
Возвращаемые значения
Примечания
- Статус

Описание

Синхронизирует содержимое двух каталогов на удалённой машине.
Под капотом используется RoboCopy, так как он должен быть доступен на большинстве современных системах Windows.

Параметры

параметр	обязательно	значение по умолчанию	выбор	комментарии
dest	да			Целевой файл/каталог для синхронизации (получит содержимое src).
flags	нет			Непосредственно передать флаги Robocopy. Если задано, `purge` и `recurse` будут проигнорированы.
purge	нет	нет	да нет	Удаляет любые файлы/каталоги, найденные в целевом каталоге, которые отсутствуют в исходном каталоге. Включает флаг `/purge` в RoboCopy. Если задан `flags`, это будет проигнорировано.
recurse	нет	нет	да нет	Включает все подкаталоги (включает флаг `/e` в RoboCopy). Если `flags` задано, это будет проигнорировано.
src	да			Исходный файл/каталог для синхронизации.

Примеры

- name: Sync the contents of one directory to another
  win_robocopy:
    src: C:\DirectoryOne
    dest: C:\DirectoryTwo

- name: Sync the contents of one directory to another, including subdirectories
  win_robocopy:
    src: C:\DirectoryOne
    dest: C:\DirectoryTwo
    recurse: yes

- name: Sync the contents of one directory to another, and remove any files/directories found in destination that do not exist in the source
  win_robocopy:
    src: C:\DirectoryOne
    dest: C:\DirectoryTwo
    purge: yes

- name: Sync content in recursive mode, removing any files/directories found in destination that do not exist in the source
  win_robocopy:
    src: C:\DirectoryOne
    dest: C:\DirectoryTwo
    recurse: yes
    purge: yes

- name: Sync two directories in recursive and purging mode, specifying additional special flags
  win_robocopy:
    src: C:\DirectoryOne
    dest: C:\DirectoryTwo
    flags: /E /PURGE /XD SOME_DIR /XF SOME_FILE /MT:32

Возвращаемые значения

Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для данного модуля:

имя	описание	возвращено	тип	пример
cmd	Использованная командная строка	всегда	строка	robocopy C:\DirectoryOne C:\DirectoryTwo /e /purge
dest	Целевой файл/каталог синхронизации.	всегда	строка	C:\Some\Path
flags	Любые флаги, переданные пользователем.	всегда	строка	/e /purge
msg	Вывод интерпретируется в краткое сообщение.	всегда	строка	Файлы не скопированы!
output	Вывод выполнения команды robocopy.	успех	строка	------------------------------------\n ROBOCOPY :: Robust File Copy for Windows \n------------------------------------\n
purge	Признак включения флага purge.	всегда	логическое	False
rc	Код возврата, возвращённый robocopy.	успех	целое число	1
recurse	Признак включения флага recurse.	всегда	логическое	False
src	Исходный файл/каталог синхронизации.	всегда	строка	C:\Some\Path

Примечания

Примечание

Это не полная переработка модуля synchronize. В отличие от модуля synchronize, он выполняет синхронизацию/копирование только на удаленной машине, а не с главной на удаленную.
Этот модуль в настоящее время не поддерживает все флаги Robocopy.

Статус

Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратной совместимости.

Для получения помощи в разработке модулей, если вы заинтересованы, пожалуйста, ознакомьтесь с Информация о сообществе и вклад, Тестирование 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_robocopy_module.html