win_xml – Добавление фрагмента XML к родительскому XML

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

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

Описание

Добавляет фрагменты XML, отформатированные как строки, к существующему XML на удаленных серверах.
Для платформ, отличных от Windows, используйте модуль xml вместо этого.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
attribute строка		Имя атрибута, если тип 'атрибут'. Требуется, если `type=attribute`.
backup булево	Варианты: нет ← да	Определяет, нужно ли создавать резервную копию. При значении `yes`, создается резервная копия файла, включая отметку времени, чтобы вы могли восстановить исходный файл, если его неправильно перезаписали.
fragment строка / обязательно		Строковое представление добавляемого фрагмента XML. Псевдонимы: xmlstring
path путь / обязательно		Путь к XML удаленного сервера. Псевдонимы: dest, file
type строка / обязательно	Варианты: атрибут элемент ← текст	Тип XML, с которым вы работаете.
xpath строка / обязательно		Узел XML удаленного сервера, куда будет помещен фрагмент.

Примеры

- name: Apply our filter to Tomcat web.xml
  win_xml:
   path: C:\apache-tomcat\webapps\myapp\WEB-INF\web.xml
   fragment: '<filter><filter-name>MyFilter</filter-name><filter-class>com.example.MyFilter</filter-class></filter>'
   xpath: '/*'

- name: Apply sslEnabledProtocols to Tomcat's server.xml
  win_xml:
   path: C:\Tomcat\conf\server.xml
   xpath: '//Server/Service[@name="Catalina"]/Connector[@port="9443"]'
   attribute: 'sslEnabledProtocols'
   fragment: 'TLSv1,TLSv1.1,TLSv1.2'
   type: attribute

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

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

Ключ	Возвращаемое значение	Описание
backup_file строка	если backup=да	Имя созданного файла резервной копии. Пример: C:\Путь\К\Файлу.txt.11540.20150212-220915.bak
err список	всегда, для типа элемент и -vvv или более	Исключения сравнения XML. Пример: несоответствие атрибута для actual=string
msg строка	всегда	Выполненные действия. Пример: xml добавлен

Статус

Интерфейс этого модуля не гарантирует обратной совместимости. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Richard Levenberg (@richardcs)

Подсказка

Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/win_xml_module.html