win_lineinfile - Обеспечение наличия определённой строки в файле или замена существующей строки с использованием обратной ссылки на регулярное выражение.

• Обзор
• Параметры
• Примечания
• Примеры
• Статус
  • Автор

Обзор

• Этот модуль ищет строку в файле и гарантирует её присутствие или отсутствие.
• Это в первую очередь полезно, когда требуется изменить только одну строку в файле.

Параметры

Примечания

Примеры

# Before 2.3, option 'dest', 'destfile' or 'name' was used instead of 'path'
- name: insert path without converting \r\n
  win_lineinfile:
    path: c:\file.txt
    line: c:\return\new

- win_lineinfile:
    path: C:\temp\example.conf
    regexp: '^name='
    line: 'name=JohnDoe'

- win_lineinfile:
    path: C:\temp\example.conf
    regexp: '^name='
    state: absent

- win_lineinfile:
    path: C:\temp\example.conf
    regexp: '^127\.0\.0\.1'
    line: '127.0.0.1 localhost'

- win_lineinfile:
    path: C:\temp\httpd.conf
    regexp: '^Listen '
    insertafter: '^#Listen '
    line: Listen 8080

- win_lineinfile:
    path: C:\temp\services
    regexp: '^# port for http'
    insertbefore: '^www.*80/tcp'
    line: '# port for http by default'

# Create file if it doesn't exist with a specific encoding
- win_lineinfile:
    path: C:\temp\utf16.txt
    create: yes
    encoding: utf-16
    line: This is a utf-16 encoded file

# Add a line to a file and ensure the resulting file uses unix line separators
- win_lineinfile:
    path: C:\temp\testfile.txt
    line: Line added to file
    newline: unix

# Update a line using backrefs
- win_lineinfile:
    path: C:\temp\example.conf
    backrefs: yes
    regexp: '(^name=)'
    line: '$1JohnDoe'

Статус

Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратимо совместимый.

Автор

• Brian Lloyd <brian.d.lloyd@gmail.com>