Set-ADUserPrimaryGroup

1.0.3

Set-ADUserPrimaryGroup.ps1


<#PSScriptInfo
 
.VERSION 1.0.3
 
.GUID 32f72580-a957-48f1-ba2e-da24f5550bb6
 
.AUTHOR saw-friendship
 
.COMPANYNAME
 
.COPYRIGHT
 
.TAGS ActiveDirectory AD User Primary Group Member
 
.LICENSEURI
 
.PROJECTURI
 
.ICONURI
 
.EXTERNALMODULEDEPENDENCIES
 
.REQUIREDSCRIPTS
 
.EXTERNALSCRIPTDEPENDENCIES
 
.RELEASENOTES
 
 
#>

<#
 
.EXAMPLE
Get-ADUser -Filter {Name -like 'u6*'} -Properties primaryGroupID,MemberOf | Set-ADUserPrimaryGroup -Group (Get-ADGroup 'Domain Users')
 
.EXAMPLE
Set-ADUserPrimaryGroup u676 'Domain Users'
 
.EXAMPLE
Set-ADUserPrimaryGroup u676,u677 'Domain Users'
 
.EXAMPLE
Get-ADUser u676 | Set-ADUserPrimaryGroup -Group (Get-ADGroup 'Domain Users')
 
.EXAMPLE
Get-ADUser -Filter {Name -like 'u6*'} | Set-ADUserPrimaryGroup -Group 'Domain Users'
 
.DESCRIPTION
 Script for change the primary group of an AD user
 
#> 

Param (
        [Parameter(Mandatory=$true,ValueFromPipeline=$true)]$User,
        [Parameter(Mandatory=$true)]$Group
    )
    Begin {
        if ($Group.SID) {
            $ADGroup = $Group
        } else {
            $ADGroup = $Group | Get-ADGroup
        }
        
        $primaryGroupID = $ADGroup.SID -replace @('.+\-','')
        
    }
    
    Process {
        $User | % {
            if ($_.PropertyNames -contains 'primaryGroupID' -and $_.PropertyNames -contains 'MemberOf') {
                $ADUser = $_
            } else {
                $ADUser = $_ | Get-ADUser -Properties primaryGroupID,MemberOf
            }
            
            if ($ADUser.MemberOf -notcontains $ADGroup.DistinguishedName) {
                try {
                    Add-ADGroupMember -Identity $ADGroup.DistinguishedName -Members $ADUser.SID -ErrorAction SilentlyContinue
                } catch {    
                    # Write-Error $Error[0]
                    exit
                }
            }

            $ADUser | Set-ADUser -Replace @{'primaryGroupID' = $primaryGroupID} -ErrorAction SilentlyContinue -PassThru | Get-ADUser -Properties primaryGroup,primaryGroupID,MemberOf
        }
    }
    
    End {}