win_xml – Add XML fragment to an XML parent
win_xml – Add XML fragment to an XML parent
New in version 2.7.
Synopsis
- Adds XML fragments formatted as strings to existing XML on remote servers.
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
attribute - |
The attribute name if the type is 'attribute'. Required if | |
backup boolean |
|
Whether to backup the remote server's XML before applying the change. |
fragment - / required |
The string representation of the XML fragment to be added.
| |
path - / required |
The path of remote servers XML.
| |
type - / required |
|
The type of XML you are working with. |
xpath - / required |
The node of the remote server XML where the fragment will go. |
Examples
# 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
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
backup string |
changed |
name of the backup file, if created
Sample: C:\config.xml.19700101-000000 |
err list |
always, for type element and -vvv or more |
xml comparison exceptions
Sample: attribute mismatch for actual=string |
msg string |
always |
what was done
Sample: xml added |
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- 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