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

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

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

Описание

Добавляет фрагменты XML, отформатированные как строки, к существующему XML на удалённых серверах.

Параметры

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

Примеры

# 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: '/*'

# 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 строка	изменено	имя резервной копии, если она была создана Пример: C:\config.xml.19700101-000000
err список	всегда, для типа element и -vvv или более	исключения сравнения XML Пример: несоответствие атрибутов для actual=string
msg строка	всегда	выполненные действия Пример: xml добавлен

Статус

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

Авторы

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.7/modules/win_xml_module.html