Public/Remove-DisabledADProfiles.ps1
|
<#
.Description This function leverages PSRemoting to import the AD module and query Active Directory Accounts. It will then parse through existing profiles on the local machine to make sure they don't belong to disabled or missing Active Directory Accounts If a profile matches a missing or disable Active Directroy account it will be deleted on the local endpoint. .Notes This function requires Powershell Remoting be enabled on the leveraged domain controller. If PSRemoting is disabled run the command <Enable-PSRemoting -force> on the domain controller .Parameter domaincontroller Specify a a domain controller that has Powershell remoting enabled .EXAMPLE Remove-DisabledADProfiles -domaincontroller DomainControllerDNSName Use Computername to specify the Domain Controller to be queried for active domain accounts .Notes Previously used wmi and now uses Cim for removing profiles. If seeing issues with the new method in the future consider updating the function to use either or method, or develop a 3rd method entirely. .Link https://github.com/TheTaylorLee/AdminToolbox #> function Remove-DisabledADProfiles { [CmdletBinding()] [Alias('rdad')] Param ( [Parameter(Mandatory = $true)]$domaincontroller ) #Check For Admin Privleges Get-Elevation try { $DCSession = New-PSSession -ComputerName $domaincontroller Invoke-Command -Command { Import-Module ActiveDirectory } -Session $DCSession Import-PSSession -Session $DCSession -Module ActiveDirectory -AllowClobber $profiles = Get-CimInstance -Class Win32_UserProfile foreach ($prof in $profiles) { $sid = $prof.sid $ADUser = Get-ADUser -Filter * | Where-Object sid -EQ $sid if ($ADUser.enabled -eq $false) { #delete profile "Delete $($ADUser.name)" $prof | Remove-CimInstance } } } catch { Write-Output $_.Exception.Message } } |