Nota

Este complemento es parte del colección community.windows (versión 1.2.0).

Para instalarlo usa: ansible-galaxy collection install community.windows.

Para usarlo en un libro de jugadas, especifique: community.windows.win_xml.

  • Sinopsis
  • Parámetros
  • notas
  • Ver también
  • Ejemplos
  • Valores devueltos

Sinopsis

  • Administra nodos XML, attributes y texto, usando xpath para seleccionar qué nodos xml deben administrarse.
  • Los fragmentos XML, formateados como cadenas, se utilizan para especificar el estado deseado de una parte o partes de archivos XML en servidores remotos de Windows.
  • Para destinos que no sean de Windows, use el comunidad.general.xml módulo en su lugar.

Parámetros

Parámetro Opciones/Predeterminados Comentarios
attributestring Él attribute nombre si el tipo es ‘attribute’.Requerido si type=attribute.
respaldobooleano
    Opciones:

  • no ←
  • sí
 Determine si se debe crear una copia de seguridad. Cuando se establece en yescree un archivo de respaldo que incluya la información de la marca de tiempo para que pueda recuperar el archivo original si de alguna manera lo golpeó incorrectamente.
contarbooleano
    Opciones:

  • no ←
  • sí
 cuando se establece en yesdevuelve el número de nodos que coinciden con xpath.
fragmentostring Él string representación del fragmento XML esperado en xpath. Dado que ansible 2.9 no es necesario cuando estado=ausenteo cuando cuenta=sí.
alias: cadena xml
senderosendero / requerido Ruta al archivo a operar.
alias: destino, archivo
Expresarstring
    Opciones:

  • presente ←
  • ausente
 Establecer o eliminar los nodos (o attributes) emparejado por xpath.
tipostring / requerido
    Opciones:

  • attribute
  • elemento ←
  • texto
 El tipo de nodo XML con el que está trabajando.
xpathstring / requerido Xpath para seleccionar el nodo o nodos en los que operar.

notas

Nota

  • Solo admite operar en elementos xml, attributes y texto
  • Los tipos de nodos de espacios de nombres, instrucciones de procesamiento, comandos y documentos no se pueden modificar con este módulo.

Ver también

Ver también

comunidad.general.xml

Manipulación de XML para hosts Posix.

Tutorial XPath de w3shools

Un tutorial útil sobre XPath

Ejemplos

-name: Apply our filter to Tomcat web.xml
  community.windows.win_xml:path: C:apache-tomcatwebappsmyappWEB-INFweb.xml
   fragment:'MyFiltercom.example.MyFilter'xpath:'/*'-name: Apply sslEnabledProtocols to Tomcat's server.xml
  community.windows.win_xml:path: C:Tomcatconfserver.xml
   xpath:'//Server/Service[@name="Catalina"]/Connector[@port="9443"]'attribute:'sslEnabledProtocols'fragment:'TLSv1,TLSv1.1,TLSv1.2'type: attribute

-name: remove debug configuration nodes from nlog.conf
  community.windows.win_xml:path: C:IISApplicationnlog.conf
   xpath: /nlog/rules/logger[@name="debug"]/descendant::*
   state: absent

-name: count configured connectors in Tomcat's server.xml
  community.windows.win_xml:path: C:Tomcatconfserver.xml
   xpath: //Server/Service/Connector
   count: yes
  register: connector_count

-name: show connector count
  debug:
    msg="Connector count is connector_count.count"

-name: ensure all lang=en attributes to lang=nl
  community.windows.win_xml:path: C:DataBooks.xml
   xpath: //@[lang="en"]attribute: lang
   fragment: nl
   type: attribute

Valores devueltos

Los valores de retorno comunes están documentados aquílos siguientes son los campos exclusivos de este módulo:

Llave devuelto Descripción
archivo de respaldostring si copia de seguridad = sí Nombre del archivo de copia de seguridad que se creó.
Muestra:C:RutaAlArchivo.txt.11540.20150212-220915.bak
contarentero si cuenta = si Número de nodos coincidentes por xpath.
Muestra:33
errarlista / elementos=string siempre, para elemento de tipo y -vvv o más Excepciones de comparación XML.
Muestra:attribute discrepancia para real=string
mensajestring siempre Lo que fue hecho.
Muestra:xml agregado

Autores

  • Richard Levenberg (@richardcs)
  • Jon Hawkesworth (@jhawkesworth)