community.windows.win_dhcp_lease – Управление арендами DHCP Windows Server

Примечание

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

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

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

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

Обзор

Управление арендами DHCP Windows Server (только IPv4)
Добавление, удаление и изменение аренд и резерваций DHCP
Задача должна быть делегирована серверу DHCP Windows

Требования

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

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
description строка		Указывает описание резервации, которая создается. Применимо только к l(type=reservation).
dns_hostname строка		Указывает DNS-имя хоста клиента, для которого требуется добавить аренду IP-адреса.
dns_regtype строка	Варианты: aptr ← a noreg	Указывает тип DNS-записи, которая будет зарегистрирована службой сервера DHCP для этой аренды. l(a) приводит к регистрации записи A. l(aptr) приводит к регистрации записей A и PTR. l(noreg) приводит к тому, что DNS-записи не регистрируются.
duration целое число		Указывает срок аренды DHCP в днях. Значение duration применяется только к l(type=lease). По умолчанию используется значение, указанное в конфигурации сервера DHCP. Применимо только к l(type=lease).
ip строка		IP-адрес клиента (сервера/компьютера) в формате IPv4. Обязательный параметр, если l(mac) не задан. Можно использовать для идентификации существующей аренды/резервации вместо l(mac).
mac строка		Указывает идентификатор клиента, который будет установлен для IP-адреса IPv4. Обязательный параметр, если l(ip) не задан. Клиенты Windows используют MAC-адрес в качестве идентификатора клиента. Linux и другие операционные системы могут использовать другие типы идентификаторов. Можно использовать для идентификации существующей аренды/резервации вместо l(ip).
reservation_name строка		Указывает имя резервации, которая создается. Применимо только к l(type=reservation).
scope_id строка		Указывает идентификатор области, как определено сервером DHCP. Обязательный параметр, если l(state=present) и резервация или аренда еще не существует. Не требуется, если обновляется существующая аренда или резервация.
state строка	Варианты: present ← absent	Указывает желаемое состояние аренды DHCP или резервации.
type строка	Варианты: reservation ← lease	Тип DHCP-адреса. Аренды истекают в соответствии с l(duration). Если l(duration) не указан, используется значение по умолчанию сервера. Резервации являются постоянными.

Примеры

- name: Ensure DHCP reservation exists
  community.windows.win_dhcp_lease:
    type: reservation
    ip: 192.168.100.205
    scope_id: 192.168.100.0
    mac: 00:B1:8A:D1:5A:1F
    dns_hostname: "{{ ansible_inventory }}"
    description: Testing Server

- name: Ensure DHCP lease or reservation does not exist
  community.windows.win_dhcp_lease:
    mac: 00:B1:8A:D1:5A:1F
    state: absent

- name: Ensure DHCP lease or reservation does not exist
  community.windows.win_dhcp_lease:
    ip: 192.168.100.205
    state: absent

- name: Convert DHCP lease to reservation & update description
  community.windows.win_dhcp_lease:
    type: reservation
    ip: 192.168.100.205
    description: Testing Server

- name: Convert DHCP reservation to lease
  community.windows.win_dhcp_lease:
    type: lease
    ip: 192.168.100.205

Возвращаемые значения

Общие значения возврата документированы здесь, следующие поля уникальны для данного модуля:

Ключ	Возвращаемое значение	Описание
lease словарь	При l(state=present)	Параметры нового/обновленного объекта DHCP Пример: {'address_state': 'InactiveReservation', 'client_id': '0a-0b-0c-04-05-aa', 'description': 'Действительно стильная', 'ip_address': '172.16.98.230', 'name': None, 'scope_id': '172.16.98.0'}

Авторы

Joe Zollo (@joezollo)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/windows/win_dhcp_lease_module.html