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

Примечание

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

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

Для использования в книге задач укажите: 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/windows/win_hosts_module.html