Модуль community.windows.win_hosts — Управление записями файла hosts в Windows.

Примечание

Этот модуль входит в коллекцию community.windows (версия 2.3.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить её установку, выполните ansible-galaxy collection list.

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

Чтобы использовать его в книге задач, укажите: community.windows.win_hosts.

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

Обзор

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

Параметры

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

Примечания

Примечание

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

См. также

ansible.windows.win_template: Шаблонирование файла на удалённом сервере.
ansible.windows.win_file: Создаёт, изменяет метку времени или удаляет файлы или директории.
ansible.windows.win_copy: Копирует файлы на удалённые локации на хостах Windows.

Примеры

- 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/windows/win_hosts_module.html