#!powershell # This file is part of Ansible # # Copyright 2014, Paul Durivage # # Ansible is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # Ansible is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with Ansible. If not, see . # WANT_JSON # POWERSHELL_COMMON ######## $ADS_UF_PASSWD_CANT_CHANGE = 64 $ADS_UF_DONT_EXPIRE_PASSWD = 65536 $adsi = [ADSI]"WinNT://$env:COMPUTERNAME" function Get-User($user) { $adsi.Children | where {$_.SchemaClassName -eq 'user' -and $_.Name -eq $user } return } function Get-UserFlag($user, $flag) { If ($user.UserFlags[0] -band $flag) { $true } Else { $false } } function Set-UserFlag($user, $flag) { $user.UserFlags = ($user.UserFlags[0] -BOR $flag) } function Clear-UserFlag($user, $flag) { $user.UserFlags = ($user.UserFlags[0] -BXOR $flag) } ######## $params = Parse-Args $args; $result = New-Object psobject @{ changed = $false }; If (-not $params.name.GetType) { Fail-Json $result "missing required arguments: name" } $username = Get-Attr $params "name" $fullname = Get-Attr $params "fullname" $description = Get-Attr $params "description" $password = Get-Attr $params "password" If ($params.state) { $state = $params.state.ToString().ToLower() If (($state -ne 'present') -and ($state -ne 'absent') -and ($state -ne 'query')) { Fail-Json $result "state is '$state'; must be 'present', 'absent' or 'query'" } } ElseIf (!$params.state) { $state = "present" } If ($params.update_password) { $update_password = $params.update_password.ToString().ToLower() If (($update_password -ne 'always') -and ($update_password -ne 'on_create')) { Fail-Json $result "update_password is '$update_password'; must be 'always' or 'on_create'" } } ElseIf (!$params.update_password) { $update_password = "always" } $password_expired = Get-Attr $params "password_expired" $null If ($password_expired -ne $null) { $password_expired = $password_expired | ConvertTo-Bool } $password_never_expires = Get-Attr $params "password_never_expires" $null If ($password_never_expires -ne $null) { $password_never_expires = $password_never_expires | ConvertTo-Bool } $user_cannot_change_password = Get-Attr $params "user_cannot_change_password" $null If ($user_cannot_change_password -ne $null) { $user_cannot_change_password = $user_cannot_change_password | ConvertTo-Bool } $account_disabled = Get-Attr $params "account_disabled" $null If ($account_disabled -ne $null) { $account_disabled = $account_disabled | ConvertTo-Bool } $account_locked = Get-Attr $params "account_locked" $null If ($account_locked -ne $null) { $account_locked = $account_locked | ConvertTo-Bool if ($account_locked) { Fail-Json $result "account_locked must be set to 'no' if provided" } } $groups = Get-Attr $params "groups" $null If ($groups -ne $null) { If ($groups.GetType().Name -eq "String") { [string[]]$groups = $groups.Split(",") } ElseIf ($groups.GetType().Name -ne "Object[]") { Fail-Json $result "groups must be a string or array" } $groups = $groups | ForEach { ([string]$_).Trim() } | Where { $_ } If ($groups -eq $null) { $groups = @() } } If ($params.groups_action) { $groups_action = $params.groups_action.ToString().ToLower() If (($groups_action -ne 'replace') -and ($groups_action -ne 'add') -and ($groups_action -ne 'remove')) { Fail-Json $result "groups_action is '$groups_action'; must be 'replace', 'add' or 'remove'" } } ElseIf (!$params.groups_action) { $groups_action = "replace" } $user_obj = Get-User $username If ($state -eq 'present') { # Add or update user try { If (!$user_obj.GetType) { $user_obj = $adsi.Create("User", $username) If ($password -ne $null) { $user_obj.SetPassword($password) } $user_obj.SetInfo() $result.changed = $true } ElseIf (($password -ne $null) -and ($update_password -eq 'always')) { [void][system.reflection.assembly]::LoadWithPartialName('System.DirectoryServices.AccountManagement') $host_name = [System.Net.Dns]::GetHostName() $pc = New-Object -TypeName System.DirectoryServices.AccountManagement.PrincipalContext 'Machine', $host_name # ValidateCredentials fails if PasswordExpired == 1 If (!$pc.ValidateCredentials($username, $password)) { $user_obj.SetPassword($password) $result.changed = $true } } If (($fullname -ne $null) -and ($fullname -ne $user_obj.FullName[0])) { $user_obj.FullName = $fullname $result.changed = $true } If (($description -ne $null) -and ($description -ne $user_obj.Description[0])) { $user_obj.Description = $description $result.changed = $true } If (($password_expired -ne $null) -and ($password_expired -ne ($user_obj.PasswordExpired | ConvertTo-Bool))) { $user_obj.PasswordExpired = If ($password_expired) { 1 } Else { 0 } $result.changed = $true } If (($password_never_expires -ne $null) -and ($password_never_expires -ne (Get-UserFlag $user_obj $ADS_UF_DONT_EXPIRE_PASSWD))) { If ($password_never_expires) { Set-UserFlag $user_obj $ADS_UF_DONT_EXPIRE_PASSWD } Else { Clear-UserFlag $user_obj $ADS_UF_DONT_EXPIRE_PASSWD } $result.changed = $true } If (($user_cannot_change_password -ne $null) -and ($user_cannot_change_password -ne (Get-UserFlag $user_obj $ADS_UF_PASSWD_CANT_CHANGE))) { If ($user_cannot_change_password) { Set-UserFlag $user_obj $ADS_UF_PASSWD_CANT_CHANGE } Else { Clear-UserFlag $user_obj $ADS_UF_PASSWD_CANT_CHANGE } $result.changed = $true } If (($account_disabled -ne $null) -and ($account_disabled -ne $user_obj.AccountDisabled)) { $user_obj.AccountDisabled = $account_disabled $result.changed = $true } If (($account_locked -ne $null) -and ($account_locked -ne $user_obj.IsAccountLocked)) { $user_obj.IsAccountLocked = $account_locked $result.changed = $true } If ($result.changed) { $user_obj.SetInfo() } If ($groups.GetType) { [string[]]$current_groups = $user_obj.Groups() | ForEach { $_.GetType().InvokeMember("Name", "GetProperty", $null, $_, $null) } If (($groups_action -eq "remove") -or ($groups_action -eq "replace")) { ForEach ($grp in $current_groups) { If ((($groups_action -eq "remove") -and ($groups -contains $grp)) -or (($groups_action -eq "replace") -and ($groups -notcontains $grp))) { $group_obj = $adsi.Children | where { $_.SchemaClassName -eq 'Group' -and $_.Name -eq $grp } If ($group_obj.GetType) { $group_obj.Remove($user_obj.Path) $result.changed = $true } Else { Fail-Json $result "group '$grp' not found" } } } } If (($groups_action -eq "add") -or ($groups_action -eq "replace")) { ForEach ($grp in $groups) { If ($current_groups -notcontains $grp) { $group_obj = $adsi.Children | where { $_.SchemaClassName -eq 'Group' -and $_.Name -eq $grp } If ($group_obj.GetType) { $group_obj.Add($user_obj.Path) $result.changed = $true } Else { Fail-Json $result "group '$grp' not found" } } } } } } catch { Fail-Json $result $_.Exception.Message } } ElseIf ($state -eq 'absent') { # Remove user try { If ($user_obj.GetType) { $username = $user_obj.Name.Value $adsi.delete("User", $user_obj.Name.Value) $result.changed = $true $user_obj = $null } } catch { Fail-Json $result $_.Exception.Message } } try { If ($user_obj.GetType) { $user_obj.RefreshCache() Set-Attr $result "name" $user_obj.Name[0] Set-Attr $result "fullname" $user_obj.FullName[0] Set-Attr $result "path" $user_obj.Path Set-Attr $result "description" $user_obj.Description[0] Set-Attr $result "password_expired" ($user_obj.PasswordExpired | ConvertTo-Bool) Set-Attr $result "password_never_expires" (Get-UserFlag $user_obj $ADS_UF_DONT_EXPIRE_PASSWD) Set-Attr $result "user_cannot_change_password" (Get-UserFlag $user_obj $ADS_UF_PASSWD_CANT_CHANGE) Set-Attr $result "account_disabled" $user_obj.AccountDisabled Set-Attr $result "account_locked" $user_obj.IsAccountLocked Set-Attr $result "sid" (New-Object System.Security.Principal.SecurityIdentifier($user_obj.ObjectSid.Value, 0)).Value $user_groups = @() ForEach ($grp in $user_obj.Groups()) { $group_result = New-Object psobject @{ name = $grp.GetType().InvokeMember("Name", "GetProperty", $null, $grp, $null) path = $grp.GetType().InvokeMember("ADsPath", "GetProperty", $null, $grp, $null) } $user_groups += $group_result; } Set-Attr $result "groups" $user_groups Set-Attr $result "state" "present" } Else { Set-Attr $result "name" $username Set-Attr $result "msg" "User '$username' was not found" Set-Attr $result "state" "absent" } } catch { Fail-Json $result $_.Exception.Message } Exit-Json $result