win_robocopy - Синхронизирует содержимое двух каталогов с помощью Robocopy
Новое в версии 2.2.
Описание
- Синхронизирует содержимое двух каталогов на удалённой машине.
- Под капотом это просто вызов RoboCopy, так как он должен быть доступен на большинстве современных системах Windows.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| dest обязательно | Целевой файл/каталог для синхронизации (получит содержимое src). | |
| flags | Непосредственно передайте флаги Robocopy. Если задано, purge и recurse будут проигнорированы. | |
| purge bool |
| Удаляет любые файлы/каталоги, найденные в пункте назначения, которые отсутствуют в источнике. Переключает флаг /purge в RoboCopy. Если flags задано, это будет проигнорировано. |
| recurse bool |
| Включает все подкаталоги (переключает флаг /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 bool | всегда | Включен ли или нет флаг очистки. |
| rc int | успех | Код возврата, возвращённый robocopy. Пример: 1 |
| recurse bool | всегда | Включён ли или нет флаг рекурсии. |
| src строка | всегда | Исходный файл/каталог синхронизации. Пример: C:\Some\Path |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантированно будет обратной совместимостью.
Техническое сопровождение
Этот модуль помечен как сообщество, что означает, что его поддерживает сообщество Ansible. См. Техническое сопровождение и поддержка модулей для получения дополнительной информации.
Список других модулей, поддерживаемых сообществом Ansible, см. здесь.
Автор
- Corwin Brown (@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.6/modules/win_robocopy_module.html
