community.windows.win_hosts – Управляет записями файла hosts на Windows.

Примечание

Этот плагин является частью коллекции community.windows (версия 1.2.0).

Для его установки используйте: ansible-galaxy collection install community.windows.

Для использования в playbook, укажите: community.windows.win_hosts.

Обзор
Параметры
Примечания
См. также
Примеры

Обзор

Управляет записями файла hosts на Windows.
Сопоставляет IPv4 или IPv6 адреса с каноническими именами.
Добавляет, удаляет или устанавливает записи cname для пар ip и хост-имен.
Изменяет файл %windir%\system32\drivers\etc\hosts.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
action строка	Варианты: add remove set ←	Управляет поведением aliases. Применимо только когда `state=present`. Если `add`, каждый псевдоним в aliases будет добавлен к записи хоста. Если `set`, каждый псевдоним в aliases будет добавлен к записи хоста, а другие псевдонимы будут удалены из записи.
aliases список / элементы=строка		Список дополнительных имён (cname-записи) для записи хоста. Применимо только когда `state=present`.
canonical_name строка		Каноническое имя для записи хоста. обязательно для `state=present`.
ip_address строка		IP-адрес для записи хоста. Может быть IPv4 (A-запись) или IPv6 (AAAA-запись). Требуется для `state=present`.
state строка	Варианты: absent present ←	Указывает, должна ли запись быть присутствующей или отсутствующей. Если указано только canonical_name, когда `state=absent`, то все записи хостов с каноническим именем canonical_name будут удалены. Если указан только ip_address, когда `state=absent`, то все записи хостов с IP-адресом ip_address будут удалены. Если ip_address и canonical_name оба пропущены, когда `state=absent`, то все записи хостов будут удалены.

Примечания

Примечание

Каждое каноническое имя может быть сопоставлено только с одним IPv4 и одним IPv6 адресом. Если canonical_name указано с state=present и оказалось сопоставленным с другим IP-адресом того же типа, но отличным от ip_address, то canonical_name и все aliases будут удалены из записи и добавлены в запись с указанным IP-адресом.
Каждый псевдоним может быть сопоставлен только с одним каноническим именем. Если aliases указано с state=present и псевдоним оказался сопоставленным с другим каноническим именем, то псевдоним будет удалён из записи и либо добавлен к записи с предоставленным каноническим именем, либо удалён из неё (в зависимости от action).

См. также

ansible.windows.win_template: Официальная документация модуля ansible.windows.win_template.
ansible.windows.win_file: Официальная документация модуля ansible.windows.win_file.
ansible.windows.win_copy: Официальная документация модуля ansible.windows.win_copy.

Примеры

- name: Add 127.0.0.1 as an A record for localhost
  community.windows.win_hosts:
    state: present
    canonical_name: localhost
    ip_address: 127.0.0.1

- name: Add ::1 as an AAAA record for localhost
  community.windows.win_hosts:
    state: present
    canonical_name: localhost
    ip_address: '::1'

- name: Remove 'bar' and 'zed' from the list of aliases for foo (192.168.1.100)
  community.windows.win_hosts:
    state: present
    canonical_name: foo
    ip_address: 192.168.1.100
    action: remove
    aliases:
      - bar
      - zed

- name: Remove hosts entries with canonical name 'bar'
  community.windows.win_hosts:
    state: absent
    canonical_name: bar

- name: Remove 10.2.0.1 from the list of hosts
  community.windows.win_hosts:
    state: absent
    ip_address: 10.2.0.1

- name: Ensure all name resolution is handled by DNS
  community.windows.win_hosts:
    state: absent

Авторы

Micah Hunsberger (@mhunsber)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/windows/win_hosts_module.html