<#
.SYNOPSIS
Gets the selected user(s) Active Directory groups
.PARAMETER UserName
The name of the user to be view group memberships - automatically supplied by CU
#>
$ErrorActionPreference = "Stop"
If ( (Get-Module -Name ActiveDirectory -ErrorAction SilentlyContinue) -eq $null )
{
Try {
Import-Module ActiveDirectory
} Catch {
# capture any failure and display it in the error section, then end the script with a return
# code of 1 so that CU sees that it was not successful.
Write-Error "Not able to load the Module" -ErrorAction Continue
Write-Error $Error[1] -ErrorAction Continue
Exit 1
}
}
# Because this is the main function of the script it is put into a try/catch frame so that any errors will be
# handled in a ControlUp-friendly way.
Try {
Get-ADPrincipalGroupMembership -Identity $args[0] | select Name
} Catch {
# capture any failure and display it in the error section, then end the script with a return
# code of 1 so that CU sees that it was not successful.
Write-Error $Error[0] -ErrorAction Continue
Exit 1
}
Write-Host "The operation completed successfully."