diff --git a/lib/ansible/modules/windows/win_domain.ps1 b/lib/ansible/modules/windows/win_domain.ps1 index 7e5bc54f6a8..4039c360f8a 100644 --- a/lib/ansible/modules/windows/win_domain.ps1 +++ b/lib/ansible/modules/windows/win_domain.ps1 @@ -7,19 +7,19 @@ Set-StrictMode -Version 2 $ErrorActionPreference = "Stop" -# FUTURE: consider action wrapper to manage reboots and credential changes +# FUTURE: Consider action wrapper to manage reboots and credential changes Function Ensure-Prereqs { $gwf = Get-WindowsFeature AD-Domain-Services - If($gwf.InstallState -ne "Installed") { + if ($gwf.InstallState -ne "Installed") { $result.changed = $true - If($check_mode) { - Exit-Json $result - } - $awf = Add-WindowsFeature AD-Domain-Services - # FUTURE: check if reboot necessary + # NOTE: AD-Domain-Services includes: RSAT-AD-AdminCenter, RSAT-AD-Powershell and RSAT-ADDS-Tools + $awf = Add-WindowsFeature AD-Domain-Services -WhatIf:$check_mode + # FUTURE: Check if reboot necessary + return $true } + return $false } $params = Parse-Args $args -supports_check_mode $true @@ -29,51 +29,97 @@ $domain_netbios_name = Get-AnsibleParam -obj $params -name "domain_netbios_name" $safe_mode_admin_password = Get-AnsibleParam -obj $params -name "safe_mode_password" -failifempty $true $database_path = Get-AnsibleParam -obj $params -name "database_path" -type "path" $sysvol_path = Get-AnsibleParam -obj $params -name "sysvol_path" -type "path" +$create_dns_delegation = Get-AnsibleParam -obj $params -name "create_dns_delegation" -type "bool" +$domain_mode = Get-AnsibleParam -obj $params -name "domain_mode" -type "str" +$forest_mode = Get-AnsibleParam -obj $params -name "forest_mode" -type "str" -$forest = $null - -# FUTURE: support down to Server 2012? -If([System.Environment]::OSVersion.Version -lt [Version]"6.3.9600.0") { +# FUTURE: Support down to Server 2012? +if ([System.Environment]::OSVersion.Version -lt [Version]"6.3.9600.0") { Fail-Json -message "win_domain requires Windows Server 2012R2 or higher" } -$result = @{changed=$false; reboot_required=$false} - -# FUTURE: any sane way to do the detection under check-mode *without* installing the feature? - -Ensure-Prereqs - -Try { - $forest = Get-ADForest $dns_domain_name -ErrorAction SilentlyContinue +# Check that domain_netbios_name is less than 15 characters +if ($domain_netbios_name -and $domain_netbios_name.length -gt 15) { + Fail-Json -message "The parameter 'domain_netbios_name' should not exceed 15 characters in length" } -Catch { } -If(-not $forest) { +$result = @{ + changed=$false; + reboot_required=$false; +} + +# FUTURE: Any sane way to do the detection under check-mode *without* installing the feature? +$installed = Ensure-Prereqs + +# when in check mode and the prereq was "installed" we need to exit early as +# the AD cmdlets weren't really installed +if ($check_mode -and $installed) { + Exit-Json -obj $result +} + +# Check that we got a valid domain_mode +$valid_domain_modes = [Enum]::GetNames((Get-Command -Name Install-ADDSForest).Parameters.DomainMode.ParameterType) +if (($domain_mode -ne $null) -and -not ($domain_mode -in $valid_domain_modes)) { + Fail-Json -obj $result -message "The parameter 'domain_mode' does not accept '$domain_mode', please use one of: $valid_domain_modes" +} + +# Check that we got a valid forest_mode +$valid_forest_modes = [Enum]::GetNames((Get-Command -Name Install-ADDSForest).Parameters.ForestMode.ParameterType) +if (($forest_mode -ne $null) -and -not ($forest_mode -in $valid_forest_modes)) { + Fail-Json -obj $result -message "The parameter 'forest_mode' does not accept '$forest_mode', please use one of: $valid_forest_modes" +} + +$forest = $null +try { + $forest = Get-ADForest $dns_domain_name -ErrorAction SilentlyContinue +} catch { } + +if (-not $forest) { $result.changed = $true - If(-not $check_mode) { - $sm_cred = ConvertTo-SecureString $safe_mode_admin_password -AsPlainText -Force + $sm_cred = ConvertTo-SecureString $safe_mode_admin_password -AsPlainText -Force - $install_forest_args = @{ - DomainName=$dns_domain_name; - SafeModeAdministratorPassword=$sm_cred; - Confirm=$false; - SkipPreChecks=$true; - InstallDns=$true; - NoRebootOnCompletion=$true; - } - if ($database_path) { - $install_forest_args.DatabasePath = $database_path - } - if ($sysvol_path) { - $install_forest_args.SysvolPath = $sysvol_path - } - if ($domain_netbios_name) { - $install_forest_args.DomainNetBiosName = $domain_netbios_name - } - - $iaf = Install-ADDSForest @install_forest_args + $install_params = @{ + DomainName=$dns_domain_name; + SafeModeAdministratorPassword=$sm_cred; + Confirm=$false; + SkipPreChecks=$true; + InstallDns=$true; + NoRebootOnCompletion=$true; + WhatIf=$check_mode; + } + if ($database_path) { + $install_params.DatabasePath = $database_path + } + + if ($sysvol_path) { + $install_params.SysvolPath = $sysvol_path + } + + if ($domain_netbios_name) { + $install_params.DomainNetBiosName = $domain_netbios_name + } + + if ($create_dns_delegation -ne $null) { + $install_params.CreateDnsDelegation = $create_dns_delegation + } + + if ($domain_mode) { + $install_params.DomainMode = $domain_mode + } + + if ($forest_mode) { + $install_params.ForestMode = $forest_mode + } + + $iaf = Install-ADDSForest @install_params + + if ($check_mode) { + # the return value after -WhatIf does not have RebootRequired populated + # manually set to True as the domain would have been installed + $result.reboot_required = $true + } else { $result.reboot_required = $iaf.RebootRequired # The Netlogon service is set to auto start but is not started. This is diff --git a/lib/ansible/modules/windows/win_domain.py b/lib/ansible/modules/windows/win_domain.py index d79712bde4e..dc93de2d1bf 100644 --- a/lib/ansible/modules/windows/win_domain.py +++ b/lib/ansible/modules/windows/win_domain.py @@ -19,17 +19,21 @@ description: options: dns_domain_name: description: - - The DNS name of the domain which should exist and be reachable or reside on the target Windows host. + - The DNS name of the domain which should exist and be reachable or reside on the target Windows host. required: yes + type: str domain_netbios_name: description: - - The netbios name of the domain. - - If not set, then the default netbios name will be the first section of dns_domain_name, up to, but not including the first period. + - 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 version_added: '2.6' safe_mode_password: description: - - Safe mode password for the domain controller. + - Safe mode password for the domain controller. required: yes + type: str database_path: description: - The path to a directory on a fixed disk of the Windows host where the @@ -44,11 +48,34 @@ options: - If not set then the default path is C(%SYSTEMROOT%\SYSVOL). type: path version_added: '2.5' + 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 + version_added: '2.8' + domain_mode: + 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 + choices: [ Win2003, Win2008, Win2008R2, Win2012, Win2012R2, WinThreshold ] + version_added: '2.8' + forest_mode: + 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. +# - Beware that the default forest functional level in Windows Server 2008 R2 when you create a new forest is C(Win2003). + type: str + choices: [ Win2003, Win2008, Win2008R2, Win2012, Win2012R2, WinThreshold ] + version_added: '2.8' author: - - Matt Davis (@nitzmahone) +- Matt Davis (@nitzmahone) ''' -RETURN = ''' +RETURN = r''' reboot_required: description: True if changes were made that require a reboot. returned: always @@ -57,8 +84,20 @@ reboot_required: ''' EXAMPLES = r''' -- name: Ensure the named domain is reachable from the target host; if not, create the domain in a new forest residing on the target host +- name: Create new domain in a new forest on the target host win_domain: dns_domain_name: ansible.vagrant safe_mode_password: password123! + +- name: Create new Windows domain in a new forest with specific parameters + 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 '''