Модуль community.windows.win_dhcp_lease – Управление арендами DHCP-сервера Windows

Примечание

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

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

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

Чтобы использовать его в playbook, укажите: community.windows.win_dhcp_lease.

Краткое описание
Требования
Параметры
Примеры
Возвращаемые значения

Краткое описание

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

Требования

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

Этот модуль требует Windows Server 2012 или более новой версии

Параметры

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

Примеры

- 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 dictionary	Параметры объекта DHCP, новые/обновлённые Возвращается: Когда l(state=present) Пример: `{"address_state": "InactiveReservation", "client_id": "0a-0b-0c-04-05-aa", "description": "Really Fancy", "ip_address": "172.16.98.230", "name": null, "scope_id": "172.16.98.0"}`

Авторы

Joe Zollo (@joezollo)

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

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