New in version 2.0.
Create a backup file including the timestamp information so you can get the original file back if you somehow clobbered it incorrectly.
Specifies the encoding of the source text file to operate on (and thus what the output encoding will be). The default of
An explicit encoding can be passed as a string that is a valid value to pass to the .NET framework System.Text.Encoding.GetEncoding() method - see https://msdn.microsoft.com/en-us/library/system.text.encoding%28v=vs.110%29.aspx.
This is mostly useful with
If specified regular expression has no matches, EOF will be used instead. May not be used with
If specified regular expression has no matches, the line will be inserted at the end of the file. May not be used with
Specifies the line separator style to use for the modified file. This defaults to the windows line separator (
The path of the file to modify.
Note that the Windows path delimiter
Before 2.3 this option was only usable as dest, destfile and name.
aliases: dest, destfile, name
The regular expression to look for in every line of the file. For
Whether the line should be there or not.
Validation to run before copying into place. Use %s in the command to indicate the current file to validate.
The command is passed securely so shell features like expansion and pipes won't work.
# Before 2.3, option 'dest', 'destfile' or 'name' was used instead of 'path' - 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'
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.