win_robocopy — Синхронизирует содержимое двух каталогов с помощью Robocopy
Новая версия с 2.2.
Описание
- Синхронизирует содержимое двух каталогов на удалённой машине.
- Внутри, это просто вызов RoboCopy, поскольку он должен быть доступен на большинстве современных системах Windows.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| dest обязательно | Целевой файл/каталог для синхронизации (получит содержимое src). | |
| flags | Непосредственно задайте флаги Robocopy. Если установлено, purge и recurse будут проигнорированы. | |
| purge |
| Удаляет любые файлы/каталоги, найденные в целевом каталоге, которых нет в исходном. Включает флаг /purge в RoboCopy. Если установлено flags, это будет проигнорировано. |
| recurse |
| Включает все подкаталоги (включает флаг /e в RoboCopy).Если установлено flags, это будет проигнорировано. |
| src обязательно | Исходный файл/каталог для синхронизации. |
Примечания
Примечание
- Это не полная переработка модуля synchronize. В отличие от модуля synchronize, он выполняет синхронизацию/копирование только на удалённой машине, а не с главной машины на удалённую.
- Данный модуль в настоящее время не поддерживает все флаги Robocopy.
Примеры
- 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 логическое | всегда | Были ли включены флаги очистки. |
| rc целое число | успех | Код возврата, возвращённый robocopy. Пример: 1 |
| recurse логическое | всегда | Были ли включены флаги рекурсии. |
| src строка | всегда | Исходный файл/каталог синхронизации. Пример: C:\Some\Path |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратной совместимости.
Автор
- Корвин Браун (@blakfeld)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/win_robocopy_module.html
