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

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

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

Обзор

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
action строка	Варианты: add remove set ←	Управляет поведением псевдонимов. Применимо только когда `state=present`. Если `add`, каждый псевдоним в псевдонимах будет добавлен в запись хоста. Если `set`, каждый псевдоним в псевдонимах будет добавлен в запись хоста, а другие псевдонимы будут удалены из записи.
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_template.
win_file – Создание, изменение или удаление файлов или каталогов: Официальная документация по модулю win_file.
win_copy – Копирование файлов на удалённые места на хостах Windows: Официальная документация по модулю 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_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)
  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. [community]

Авторы

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