New in version 2.3.
A description of this host.
Force host name even if not in DNS.
Full qualified domain name.
Can not be changed as it is the unique identifier.
Add the host to DNS with this IP address.
IP or hostname of IPA server
Password of administrative user
Port of IPA server
Protocol used by IPA server
Administrative account used on IPA server
List of Hardware MAC address(es) off this host.
If option is omitted MAC addresses will not be checked or changed.
If an empty list is passed all assigned MAC addresses will be removed.
MAC addresses that are already assigned but not passed will be removed.
Host hardware platform (e.g. "Lenovo T61")
Host location (e.g. "Lab 2")
Host operating system and version (e.g. "Fedora 9")
State to ensure
List of Base-64 encoded server certificates.
If option is omitted certificates will not be checked or changed.
If an emtpy list is passed all assigned certificates will be removed.
Certificates already assigned but not passed will be removed.
This only applies if
If set to
This should only set to
# Ensure host is present - ipa_host: name: host01.example.com description: Example host ip_address: 192.168.0.123 ns_host_location: Lab ns_os_version: CentOS 7 ns_hardware_platform: Lenovo T61 mac_address: - "08:00:27:E3:B1:2D" - "52:54:00:BD:97:1E" state: present ipa_host: ipa.example.com ipa_user: admin ipa_pass: topsecret # Ensure host is disabled - ipa_host: name: host01.example.com state: disabled ipa_host: ipa.example.com ipa_user: admin ipa_pass: topsecret # Ensure that all user certificates are removed - ipa_host: name: host01.example.com user_certificate:  ipa_host: ipa.example.com ipa_user: admin ipa_pass: topsecret # Ensure host is absent - ipa_host: name: host01.example.com state: absent ipa_host: ipa.example.com ipa_user: admin ipa_pass: topsecret
Common return values are documented here Return Values, the following are the fields unique to this module:
|host||Host as returned by IPA API.||always||dict|
|host_diff||List of options that differ and would be changed||if check mode and a difference is found||list|
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
This module is community maintained without core committer oversight.
For more information on what this means please read Module Support