ansible / ansible.windows / 2.3.0 / module / win_domain
Removed in 3.0.0
Reason:This module has been moved into the C(microsoft.ad) collection. | Alternative:Use the M(microsoft.ad.domain) module instead.
Ensures the existence of a Windows domain
Authors: Matt Davis (@nitzmahone)
Install with ansible-galaxy collection install ansible.windows:==2.3.0
collections: - name: ansible.windows version: 2.3.0
Ensure that the domain named by C(dns_domain_name) exists and is reachable.
If the domain is not reachable, the domain is created in a new forest on the target Windows Server 2012R2+ host.
This module may require subsequent use of the M(ansible.windows.win_reboot) action if changes are made.
- name: Create new domain in a new forest on the target host ansible.windows.win_domain: dns_domain_name: ansible.vagrant safe_mode_password: password123!
- name: Create new Windows domain in a new forest with specific parameters ansible.windows.win_domain: create_dns_delegation: no database_path: C:\Windows\NTDS dns_domain_name: ansible.vagrant domain_mode: Win2012R2 domain_netbios_name: ANSIBLE forest_mode: Win2012R2 safe_mode_password: password123! sysvol_path: C:\Windows\SYSVOL register: domain_install
log_path: description: - Specifies the fully qualified, non-UNC path to a directory on a fixed disk of the local computer where the log file for this operation is written. - If not set then the default path is C(%SYSTEMROOT%\NTDS). type: path domain_mode: choices: - Win2003 - Win2008 - Win2008R2 - Win2012 - Win2012R2 - WinThreshold description: - Specifies the domain functional level of the first domain in the creation of a new forest. - The domain functional level cannot be lower than the forest functional level, but it can be higher. - The default is automatically computed and set. type: str forest_mode: choices: - Win2003 - Win2008 - Win2008R2 - Win2012 - Win2012R2 - WinThreshold description: - Specifies the forest functional level for the new forest. - The default forest functional level in Windows Server is typically the same as the version you are running. type: str install_dns: default: true description: - Whether to install the DNS service when creating the domain controller. type: bool sysvol_path: description: - The path to a directory on a fixed disk of the Windows host where the Sysvol file will be created. - If not set then the default path is C(%SYSTEMROOT%\SYSVOL). type: path database_path: description: - The path to a directory on a fixed disk of the Windows host where the domain database will be created. - If not set then the default path is C(%SYSTEMROOT%\NTDS). type: path dns_domain_name: description: - The DNS name of the domain which should exist and be reachable or reside on the target Windows host. required: true type: str safe_mode_password: description: - Safe mode password for the domain controller. required: true type: str domain_netbios_name: description: - The NetBIOS name for the root domain in the new forest. - For NetBIOS names to be valid for use with this parameter they must be single label names of 15 characters or less, if not it will fail. - If this parameter is not set, then the default is automatically computed from the value of the I(domain_name) parameter. type: str create_dns_delegation: description: - Whether to create a DNS delegation that references the new DNS server that you install along with the domain controller. - Valid for Active Directory-integrated DNS only. - The default is computed automatically based on the environment. type: bool
reboot_required: description: True if changes were made that require a reboot. returned: always sample: true type: bool