community.windows.win_dhcp_lease – Управление арендами DHCP Windows Server
Примечание
Этот плагин является частью коллекции community.windows (версия 1.2.0).
Для его установки используйте: ansible-galaxy collection install community.windows.
Для использования в книге задач укажите: community.windows.win_dhcp_lease.
Описание
- Управление арендами DHCP сервера Windows (только IPv4)
- Добавление, удаление и изменение аренд и резерваций DHCP
- Задача должна быть делегирована серверу DHCP Windows
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- Этот модуль требует Windows Server 2012 или более поздней версии
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| description строка | Указывает описание создаваемой резервации. Применимо только к l(type=reservation). | |
| dns_hostname строка | Указывает DNS имя хоста клиента, для которого необходимо добавить аренду IP-адреса. | |
| dns_regtype строка |
| Указывает тип 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-адрес. Обязательный параметр, если l(ip) не установлен. Клиенты Windows используют MAC-адрес в качестве идентификатора клиента. Linux и другие операционные системы могут использовать другие типы идентификаторов. Можно использовать для идентификации существующей аренды/резервации вместо l(ip). | |
| reservation_name строка | Указывает имя создаваемой резервации. Применимо только к l(type=reservation). | |
| scope_id строка | Указывает идентификатор области, как определено на DHCP-сервере. Требуется, если l(state=present), а резервация или аренда еще не существует. Не требуется при обновлении существующей аренды или резервации. | |
| state строка |
| Указывает желаемое состояние аренды DHCP или резервации. |
| type строка |
| Тип 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/windows/win_dhcp_lease_module.html
