win_domain: Add missing functionality (#46552)
* win_domain: Add missing functionality * Fix typo: Treshold -> Threshold * Improvements based on feedback * moved mode checks to after pre-reqs are installed
This commit is contained in:
Dag Wieers
Jordan Borean
parent
bfc3ca1da1
commit
e758f69ce3
2 changed files with 134 additions and 49 deletions
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
'''
|
||||
|
|
|
|||
Loading…
Reference in a new issue