Nota

Este complemento es parte del colección community.windows (versión 1.2.0).

Para instalarlo usa: ansible-galaxy collection install community.windows.

Para usarlo en un libro de jugadas, especifique: community.windows.win_dhcp_lease.

  • Sinopsis
  • Requisitos
  • Parámetros
  • Ejemplos
  • Valores devueltos

Sinopsis

  • Administrar arrendamientos DHCP de Windows Server (solo IPv4)
  • Agrega, elimina y modifica concesiones y reservas de DHCP
  • La tarea debe delegarse a un servidor DHCP de Windows

Requisitos

Los siguientes requisitos son necesarios en el host que ejecuta este módulo.

  • Este módulo requiere Windows Server 2012 o más reciente

Parámetros

Parámetro Opciones/Predeterminados Comentarios
descripciónstring Especifica la descripción de la reserva que se está creando. Solo aplicable a l(tipo=reserva).
nombre_host_dnsstring Especifica el nombre de host DNS del cliente para el que se agregará la concesión de la dirección IP.
dns_regtypestring
    Opciones:

  • apto
  • un
  • noreg
Indica el tipo de registro DNS que registrará el DHCP. servicio de servidor para este arrendamiento.l(a) da como resultado que se registre un registro A.l(aptr) da como resultado que se registren registros A y PTR.l(noreg) da como resultado que no se registren registros DNS.
duraciónentero Especifica la duración de la concesión de DHCP en días. El valor de duración solo se aplica a l(type=lease). El valor predeterminado es la duración especificada por la configuración del servidor DHCP. Solo se aplica a l(type=lease).
ipstring La dirección IPv4 del servidor/computadora del cliente. Este es un parámetro obligatorio, si l(mac) no está configurado. Se puede usar para identificar un arrendamiento/reserva existente, en lugar de l(mac).
Macstring Especifica el identificador de cliente que se configurará en la dirección IPv4. Este es un parámetro obligatorio, si l(ip) no está configurado. Los clientes de Windows usan la dirección MAC como ID de cliente. Linux y otros sistemas operativos pueden usar otros tipos de identificadores. Se puede utilizar para identificar un arrendamiento/reserva existente, en lugar de l(ip).
nombre_reservastring Especifica el nombre de la reserva que se está creando. Solo aplicable a l(tipo=reserva).
scope_idstring Especifica el identificador de ámbito tal como lo define el servidor DHCP. Este es un parámetro obligatorio si l(state=present) y la reserva o el arrendamiento aún no existen. No se requiere si actualiza un contrato de arrendamiento o reserva existente.
Expresarstring
    Opciones:

  • presente
  • ausente
Especifica el estado deseado de la concesión o reserva de DHCP.
tipostring
    Opciones:

  • reserva
  • arrendar
El tipo de dirección DHCP. Las concesiones caducan según lo definido por l(duración). Cuando no se especifica l(duración), se utiliza el valor predeterminado del servidor. Las reservas son permanentes.

Ejemplos

-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

Valores devueltos

Los valores de retorno comunes están documentados aquílos siguientes son los campos exclusivos de este módulo:

Llave devuelto Descripción
arrendardiccionario Cuando l(estado=presente) Parámetros de objetos DHCP nuevos/actualizados
Muestra:‘address_state’: ‘InactiveReservation’, ‘client_id’: ‘0a-0b-0c-04-05-aa’, ‘description’: ‘Really Fancy’, ‘ip_address’: ‘172.16.98.230’, ‘name’: Ninguno, ‘scope_id’: ‘172.16.98.0’

Autores

  • Joe Zollo (@joezollo)