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

Новое в версии 2.8.

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

Обзор

Управление записями файла hosts в Windows.
Сопоставление адресов IPv4 или IPv6 с каноническими именами
Добавление, удаление или установка записей cname для пар ip и имени хоста
Модификация %windir%system32driversetchosts.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
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) в запись с предоставленным каноническим именем.
См. также win_template, win_file, win_copy

Примеры

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

- name: Add ::1 as an AAAA record for localhost
  win_environment:
    state: present
    canonical_name: localhost
    ip_address: '::1'

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

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

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

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

Статус

Этот модуль не гарантирует обратную совместимость. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

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.8/modules/win_hosts_module.html