community.windows.win_dns_record – Управление записями DNS сервера Windows

Примечание

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

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

Для использования в книге задач укажите: community.windows.win_dns_record.

Обзор
Требования
Параметры
Примеры

Обзор

Управление записями DNS в существующей зоне DNS сервера Windows.

Требования

Ниже приведены требования к хосту, на котором будет выполняться этот модуль.

Для этого модуля требуется Windows 8, Server 2012 или более поздняя версия.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
computer_name строка		Указывает сервер DNS. Вы можете указать IP-адрес или любое значение, которое разрешается в IP-адрес, например, полное доменное имя (FQDN), имя хоста или имя NETBIOS.
name строка / обязательно		Имя записи.
port целое число добавлен в 1.0.0 community.windows		Номер порта записи. Требуется, когда `type=SRV`. Поддерживается только для `type=SRV`.
priority целое число добавлен в 1.0.0 community.windows		Номер приоритета для каждой службы в записи SRV. Требуется, когда `type=SRV`. Поддерживается только для `type=SRV`.
state строка	Варианты: отсутствует наличие ←	Указывает, должна ли запись существовать или нет.
ttl целое число	По умолчанию: 3600	Время жизни записи в секундах. Игнорируется, когда `state=absent`. Допустимый диапазон 1 - 31557600. Обратите внимание, что домен Active Directory может указать минимальное значение TTL и динамически увеличивать другие значения до этого минимума.
type строка / обязательно	Варианты: A AAAA CNAME NS PTR SRV	Тип записи DNS для управления. `SRV` был добавлен в релизе 1.0.0 этой коллекции. `NS` был добавлен в релизе 1.1.0 этой коллекции.
value список / элементы=строка		Значение(я) для задания. Требуется, когда `state=present`. Когда `type=PTR` необходимо указать только частичную часть IP. Несколько значений могут быть переданы, когда `type=NS` псевдонимы: значения
weight целое число добавлен в 1.0.0 community.windows		Вес, присваиваемый каждой записи службы в записи SRV. Требуется, когда `type=SRV`. Поддерживается только для `type=SRV`.
zone строка / обязательно		Имя зоны для управления (например, `example.com`). Зона должна уже существовать.

Примеры

# Demonstrate creating a matching A and PTR record.

- name: Create database server record
  community.windows.win_dns_record:
    name: "cgyl1404p.amer.example.com"
    type: "A"
    value: "10.1.1.1"
    zone: "amer.example.com"

- name: Create matching PTR record
  community.windows.win_dns_record:
    name: "1.1.1"
    type: "PTR"
    value: "db1"
    zone: "10.in-addr.arpa"

# Demonstrate replacing an A record with a CNAME

- name: Remove static record
  community.windows.win_dns_record:
    name: "db1"
    type: "A"
    state: absent
    zone: "amer.example.com"

- name: Create database server alias
  community.windows.win_dns_record:
    name: "db1"
    type: "CNAME"
    value: "cgyl1404p.amer.example.com"
    zone: "amer.example.com"

# Demonstrate creating multiple A records for the same name

- name: Create multiple A record values for www
  community.windows.win_dns_record:
    name: "www"
    type: "A"
    values:
      - 10.0.42.5
      - 10.0.42.6
      - 10.0.42.7
    zone: "example.com"

# Demonstrates a partial update (replace some existing values with new ones)
# for a pre-existing name

- name: Update www host with new addresses
  community.windows.win_dns_record:
    name: "www"
    type: "A"
    values:
      - 10.0.42.5  # this old value was kept (others removed)
      - 10.0.42.12  # this new value was added
    zone: "example.com"

# Demonstrate creating a SRV record

- name: Creating a SRV record with port number and priority
  community.windows.win_dns_record:
    name: "test"
    priority: 5
    port: 995
    state: present
    type: "SRV"
    weight: 2
    value: "amer.example.com"
    zone: "example.com"

# Demonstrate creating a NS record with multiple values

- name: Creating NS record
  community.windows.win_dns_record:
    name: "ansible.prog"
    state: present
    type: "NS"
    values:
      - 10.0.0.1
      - 10.0.0.2
      - 10.0.0.3
      - 10.0.0.4
    zone: "example.com"

Авторы

John Nelson (@johnboy2)

© 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_dns_record_module.html