Модуль community.windows.win_dns_record – Управление записями DNS Windows Server

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.windows. Для использования этого модуля потребуются дополнительные требования. Подробности см. в разделе Требования.

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

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

Описание

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

Требования

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

Этот модуль требует Windows 8, Server 2012 или более поздних версий.

Параметры

Параметр	Комментарии
aging boolean добавлен в community.windows 1.13.0	Включить aging для записи. Если установлено `false`, запись будет статической. Выбори: `false` ← (по умолчанию) `true`
computer_name string	Указывает DNS-сервер. Вы можете указать IP-адрес или любое значение, которое разрешается в IP-адрес, такое как полное доменное имя (FQDN), имя хоста или имя NETBIOS.
name string / обязательно	Имя записи.
port integer добавлен в community.windows 1.0.0	Порт записи. Требуется, когда `type=SRV`. Поддерживается только для `type=SRV`.
priority integer добавлен в community.windows 1.0.0	Номер приоритета для каждой службы в записи SRV. Требуется, когда `type=SRV`. Поддерживается только для `type=SRV`.
state string	Существование записи (существует или нет). Выбори: `"absent"` `"present"` ← (по умолчанию)
ttl integer	Время жизни записи в секундах. Игнорируется, когда `state=absent`. Допустимый диапазон: 1 - 31557600. Обратите внимание, что лес Active Directory может указать минимальное значение TTL и динамически «округлить» другие значения до этого минимума. По умолчанию: `3600`
type string / обязательно	Тип записи DNS для управления. `SRV` был добавлен в релизе 1.0.0 этой коллекции. `NS` был добавлен в релизе 1.1.0 этой коллекции. `TXT` был добавлен в релизе 1.6.0 этой коллекции. `DHCID` был добавлен в релизе 1.12.0 этой коллекции. Выбори: `"A"` `"AAAA"` `"CNAME"` `"DHCID"` `"NS"` `"PTR"` `"SRV"` `"TXT"`
value aliases: values list / elements=string	Значение(я) для указания. Требуется, когда `state=present`. Когда `type=PTR` необходимо указать только частичную часть IP. Несколько значений могут быть переданы, когда `type=NS`. По умолчанию: `[]`
weight integer добавлен в community.windows 1.0.0	Вес каждой записи службы в записи SRV. Требуется, когда `type=SRV`. Поддерживается только для `type=SRV`.
zone string / обязательно	Имя зоны для управления (например, `example.com`). Зона должна уже существовать.
zone_scope string добавлен в community.windows 2.0.0	Имя области зоны для управления (например, `ScopeAZ`). Зона должна уже существовать.

Примеры

# Demonstrate creating a matching A and PTR record.

- name: Create database server record
  community.windows.win_dns_record:
    name: "cgyl1404p"
    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"

# Demonstrate creating a TXT record

- name: Creating a TXT record with descriptive Text
  community.windows.win_dns_record:
    name: "test"
    state: present
    type: "TXT"
    value: "justavalue"
    zone: "example.com"

# Demostrate creating a A record to Zone Scope

- 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"
    zone_scope: "external"

Авторы

Sebastian Gruber (@sgruber94)
John Nelson (@johnboy2)

Ссылки на коллекцию

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