privilegedUsersV2.ps1


Description

@GitHub Copilot - Welcome @BanterBoy, I’m your Copilot and I’m here to help you get things done faster. I can identify issues, explain and even improve code.

You can ask generic questions, but what I’m really good at is helping you with your code. For example:

Generate unit tests for my code Explain the selected code Propose a fix for the bugs in my code If you want to learn more about my capabilities and limitations, check out the Copilot documentation.

I’m powered by AI, so surprises and mistakes are possible. Make sure to verify any generated code or suggestions, and share feedback so that we can learn and improve.

@BanterBoy: - Explain what the script does and why it is useful.

@GitHub Copilot -


Script

<#

    Too Many Admins in Your Domain: Expose the Problem(s) and Find a Solution
    http://blogs.technet.com/b/askpfeplat/archive/2012/07/16/too-many-admins-in-your-domain-expose-the-problem-s-and-find-a-solution-don-t-forget-powershell.aspx
    http://jeffwouters.nl/index.php/2013/11/powershell-function-to-list-users-in-authorative-groups-in-active-directory/

    Too Many Admins in Your Domain: Expose the Problem(s) and Find a Solution. (Don�t forget PowerShell)
    http://blogs.technet.com/b/askpfeplat/archive/2012/07/16/too-many-admins-in-your-domain-expose-the-problem-s-and-find-a-solution-don-t-forget-powershell.aspx

    Audit Membership in Privileged Active Directory Groups. A Second Look.
    http://blogs.technet.com/b/askpfeplat/archive/2013/04/08/audit-membership-in-privileged-active-directory-groups-a-second-look.aspx
    http://gallery.technet.microsoft.com/scriptcenter/List-Membership-In-bff89703

    This Sample Code is provided for the purpose of illustration only and is not intended to be used in a production environment.
    THIS SAMPLE CODE AND ANY RELATED INFORMATION ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING
    BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE. We grant You a nonexclusive,
    royalty-free right to use and modify the Sample Code and to reproduce and distribute the object code form of the Sample Code, provided that
    You agree: (i) to not use Our name, logo, or trademarks to market Your software product in which the Sample Code is embedded;
    (ii) to include a valid copyright notice on Your software product in which the Sample Code is embedded; and
    (iii) to indemnify, hold harmless, and defend Us and Our suppliers from and against any claims or lawsuits, including attorneys' fees,
    that arise or result from the use or distribution of the Sample Code.
    This posting is provided "AS IS" with no warranties, and confers no rights.
    Use of included script samples are subject to the terms specified at http://www.microsoft.com/info/cpyright.htm.

#>

##################   Function to Expand Group Membership ################
function getMemberExpanded {
    param ($dn)

    $colOfMembersExpanded = @()
    $adobject = [adsi]"LDAP://$dn"
    $colMembers = $adobject.properties.item("member")
    Foreach ($objMember in $colMembers) {
        $objMembermod = $objMember.replace("/", "\/")
        $objAD = [adsi]"LDAP://$objmembermod"
        $attObjClass = $objAD.properties.item("objectClass")
        if ($attObjClass -eq "group") {
            getmemberexpanded $objMember
        }
        else {
            $colOfMembersExpanded += $objMember
        }
    }
    $colOfMembersExpanded
}

########################### Function to Calculate Password Age ##############
Function getUserAccountAttribs {
    param($objADUser, $parentGroup)
    $objADUser = $objADUser.replace("/", "\/")
    $adsientry = new-object directoryservices.directoryentry("LDAP://$objADUser")
    $adsisearcher = new-object directoryservices.directorysearcher($adsientry)
    $adsisearcher.pagesize = 1000
    $adsisearcher.searchscope = "base"
    $colUsers = $adsisearcher.findall()
    foreach ($objuser in $colUsers) {
        $dn = $objuser.properties.item("distinguishedname")
        $sam = $objuser.properties.item("samaccountname")
        $attObjClass = $objuser.properties.item("objectClass")
        If ($attObjClass -eq "user") {
            $description = $objuser.properties.item("description")[0]
            #$lastlogontimestamp=$objuser.properties.item("lastlogontimestamp")
            If (($objuser.properties.item("lastlogontimestamp") | Measure-Object).Count -gt 0) {
                $lastlogontimestamp = $objuser.properties.item("lastlogontimestamp")[0]
                $lastLogon = [System.DateTime]::FromFileTime($lastlogontimestamp)
                $lastLogonInDays = ((Get-Date) - $lastLogon).Days
                if ($lastLogon -match "1/01/1601") {
                    $lastLogon = "Never logged on before"
                    $lastLogonInDays = "N/A"
                }
            }
            else {
                $lastLogon = "Never logged on before"
                $lastLogonInDays = "N/A"
            }

            $accountexpiration = $objuser.properties.item("accountexpires")
            $pwdLastSet = $objuser.properties.item("pwdLastSet")
            if ($pwdLastSet -gt 0) {
                $pwdLastSet = [datetime]::fromfiletime([int64]::parse($pwdLastSet))
                $PasswordAge = ((get-date) - $pwdLastSet).days
            }
            Else { $PasswordAge = "<Not Set>" }
            $uac = $objuser.properties.item("useraccountcontrol")
            $uac = $uac.item(0)
            if (($uac -bor 0x0002) -eq $uac) { $disabled = "TRUE" }
            else { $disabled = "FALSE" }
            if (($uac -bor 0x10000) -eq $uac) { $passwordneverexpires = "TRUE" }
            else { $passwordNeverExpires = "FALSE" }
        }
        $record = "" | select-object SAM, DN, MemberOf, pwdAge, lastlogon, lastlogonindays, disabled, pWDneverExpires, description
        $record.SAM = [string]$sam
        $record.DN = [string]$dn
        $record.memberOf = [string]$parentGroup
        $record.pwdAge = $PasswordAge
        $record.lastlogon = $lastLogon
        $record.lastlogonindays = $lastLogonInDays
        $record.disabled = $disabled
        $record.pWDneverExpires = $passwordNeverExpires
        $record.description = $description

    }
    $record
}
####### Function to find all Privileged Groups in the Forest ##########
Function getForestPrivGroups {
    # Privileged Group Membership for the following groups:
    # - Enterprise Admins - SID: S-1-5-21root domain-519
    # - Schema Admins - SID: S-1-5-21root domain-518
    # - Domain Admins - SID: S-1-5-21domain-512
    # - Cert Publishers - SID: S-1-5-21domain-517
    # - Administrators - SID: S-1-5-32-544
    # - Account Operators - SID: S-1-5-32-548
    # - Server Operators - SID: S-1-5-32-549
    # - Backup Operators - SID: S-1-5-32-551
    # - Print Operators - SID: S-1-5-32-550
    # Reference: http://support.microsoft.com/kb/243330

    $colOfDNs = @()
    $Forest = [System.DirectoryServices.ActiveDirectory.forest]::getcurrentforest()
    $RootDomain = [string]($forest.rootdomain.name)
    $forestDomains = $forest.domains
    $colDomainNames = @()
    ForEach ($domain in $forestDomains) {
        $domainname = [string]($domain.name)
        $colDomainNames += $domainname
    }

    $ForestRootDN = FQDN2DN $RootDomain
    $colDomainDNs = @()
    ForEach ($domainname in $colDomainNames) {
        $domainDN = FQDN2DN $domainname
        $colDomainDNs += $domainDN
    }

    $GC = $forest.FindGlobalCatalog()
    $adobject = [adsi]"GC://$ForestRootDN"
    $RootDomainSid = New-Object System.Security.Principal.SecurityIdentifier($AdObject.objectSid[0], 0)
    $RootDomainSid = $RootDomainSid.toString()
    $colDASids = @()
    ForEach ($domainDN in $colDomainDNs) {
        $adobject = [adsi]"GC://$domainDN"
        $DomainSid = New-Object System.Security.Principal.SecurityIdentifier($AdObject.objectSid[0], 0)
        $DomainSid = $DomainSid.toString()
        $daSid = "$DomainSID-512"
        $colDASids += $daSid
        $cpSid = "$DomainSID-517"
        $colDASids += $cpSid
    }


    $colPrivGroups = @("S-1-5-32-544"; "S-1-5-32-548"; "S-1-5-32-549"; "S-1-5-32-551"; "S-1-5-32-550"; "$rootDomainSid-519"; "$rootDomainSid-518")
    $colPrivGroups += $colDASids

    $searcher = $gc.GetDirectorySearcher()
    ForEach ($privGroup in $colPrivGroups) {
        $searcher.filter = "(objectSID=$privGroup)"
        $Results = $Searcher.FindAll()
        ForEach ($result in $Results) {
            $dn = $result.properties.distinguishedname
            $colOfDNs += $dn
        }
    }
    $colofDNs
}

########################## Function to Generate Domain DN from FQDN ########
Function FQDN2DN {
    Param ($domainFQDN)
    $colSplit = $domainFQDN.Split(".")
    $FQDNdepth = $colSplit.length
    $DomainDN = ""
    For ($i = 0; $i -lt ($FQDNdepth); $i++) {
        If ($i -eq ($FQDNdepth - 1)) { $Separator = "" }
        else { $Separator = "," }
        [string]$DomainDN += "DC=" + $colSplit[$i] + $Separator
    }
    $DomainDN
}

########################## MAIN ###########################
$forestPrivGroups = GetForestPrivGroups
$colAllPrivUsers = @()

$MaxUniqueMembers = 25
$MaxPasswordAge = 365
$DetailedConsoleOutput = $False

$rootdse = New-Object directoryservices.directoryentry("LDAP://rootdse")

Foreach ($privGroup in $forestPrivGroups) {
    Write-Host ""
    Write-Host "Enumerating $privGroup.." -foregroundColor yellow
    $uniqueMembers = @()
    $colOfMembersExpanded = @()
    $colofUniqueMembers = @()
    $members = getmemberexpanded $privGroup
    If ($members) {
        $uniqueMembers = $members | sort-object -unique
        $numberofUnique = $uniqueMembers | Measure-Object | ForEach-Object { $_.Count }
        Foreach ($uniqueMember in $uniqueMembers) {
            $objAttribs = getUserAccountAttribs $uniqueMember $privGroup
            $colOfuniqueMembers += $objAttribs
        }
        $colAllPrivUsers += $colOfUniqueMembers
    }
    Else { $numberofUnique = 0 }

    If ($numberofUnique -gt $MaxUniqueMembers) {
        Write-host "...$privGroup has $numberofUnique unique members" -foregroundColor Red
    }
    Else { Write-host "...$privGroup has $numberofUnique unique members" -foregroundColor White }

    $pwdneverExpiresCount = 0
    $pwdAgeCount = 0

    ForEach ($user in $colOfuniquemembers) {
        $i = 0
        $userpwdAge = $user.pwdAge
        $userpwdneverExpires = $user.pWDneverExpires
        $userSAM = $user.SAM
        IF ($userpwdneverExpires -eq $True) {
            $pwdneverExpiresCount ++
            $i ++
            If ($DetailedConsoleOutput) { Write-host "......$userSAM has a password age of $userpwdage and the password is set to never expire" -foregroundColor Green }
        }
        If ($userpwdAge -gt $MaxPasswordAge) {
            $pwdAgeCount ++
            If ($i -gt 0) {
                If ($DetailedConsoleOutput) { Write-host "......$userSAM has a password age of $userpwdage" -foregroundColor Green }
            }
        }
    }

    If ($numberofUnique -gt 0) {
        Write-host "......There are $pwdneverExpiresCount accounts that have the password is set to never expire." -foregroundColor Green
        Write-host "......There are $pwdAgeCount accounts that have a password age greater than $MaxPasswordAge." -foregroundColor Green
    }
}

If ($DetailedConsoleOutput) {
    write-host "`nComments:" -foregroundColor Yellow
    write-host " - If a privileged group contains more than $MaxUniqueMembers unique members, it's highlighted in red." -foregroundColor Yellow
    write-host " - The privileged user is listed if their password is set to never expire." -foregroundColor Yellow
    write-host " - The privileged user is listed if their password age is greater than $MaxPasswordAge days." -foregroundColor Yellow
    write-host " - Service accounts should not be privileged users in the domain." -foregroundColor Yellow
}

$colAllPrivUsers | Export-CSV -notype -path ".\AllPrivUsers.csv" -Delimiter ';'

# Remove the quotes
(Get-Content ".\AllPrivUsers.csv") | ForEach-Object { $_ -replace '"', "" } | out-file ".\AllPrivUsers.csv" -Force -Encoding ascii

Back to Top


Download

Please feel free to copy parts of the script or if you would like to download the entire script, simple click the download button. You can download the complete repository in a zip file by clicking the Download link in the menu bar on the left hand side of the page.


Report Issues

You can report an issue or contribute to this site on GitHub. Simply click the button below and add any relevant notes. I will attempt to respond to all issues as soon as possible.

Issue


Back to Top