Get-ADObjectConfiguration.ps1
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 |
<#
.SYNOPSIS This function gets the original DL configuration for the on premises group using AD providers. .DESCRIPTION This function gets the original DL configuration for the on premises group using AD providers. .PARAMETER parameterSet These are the parameters that the GET will gather from AD for the DL. This should be the full map. .PARAMETER GroupSMTPAddress The mail attribute of the group to search. .PARAMETER GlobalCatalog The global catalog to utilize for the query. .PARAMETER ADCredential The credential utilized to connect to the global catalog server. .PARAMETER isValidTest Signifies if the function is being called to validate the existance of a recipient .OUTPUTS Returns the DL configuration from the LDAP / AD call to the calling function. .EXAMPLE Get-ADObjectConfiguration -groupSMTPAddress $address -DN $DN -globalCatalogServer $GC -adCredential $cred -parameterSet $parameterArray #> Function Get-ADObjectConfiguration { [cmdletbinding()] Param ( [Parameter(Mandatory = $true,ParameterSetName = "BySMTPAddress")] [string]$groupSMTPAddress="None", [Parameter(Mandatory = $true,ParameterSetName = "ByDN")] [string]$dn="None", [Parameter(Mandatory = $true,ParameterSetName = "BySMTPAddress")] [Parameter(Mandatory = $true,ParameterSetName = "ByDN")] [string]$globalCatalogServer, [Parameter(Mandatory = $true,ParameterSetName = "BySMTPAddress")] [Parameter(Mandatory = $true,ParameterSetName = "ByDN")] [array]$parameterSet, [Parameter(Mandatory = $TRUE,ParameterSetName = "BySMTPAddress")] [Parameter(Mandatory = $true,ParameterSetName = "ByDN")] $adCredential, [Parameter(Mandatory = $false,ParameterSetName = "BySMTPAddress")] [Parameter(Mandatory = $false,ParameterSetName = "ByDN")] [boolean]$isValidTest=$FALSE ) #Output all parameters bound or unbound and their associated values. write-functionParameters -keyArray $MyInvocation.MyCommand.Parameters.Keys -parameterArray $PSBoundParameters -variableArray (Get-Variable -Scope Local -ErrorAction Ignore) #Declare function variables. $functionDLConfiguration=$NULL #Holds the return information for the group query. #Start function processing. Out-LogFile -string "********************************************************************************" Out-LogFile -string "BEGIN Get-ADObjectConfiguration" Out-LogFile -string "********************************************************************************" #Log the parameters and variables for the function. Out-LogFile -string ("GroupSMTPAddress = "+$groupSMTPAddress) Out-LogFile -string ("GlobalCatalogServer = "+$globalCatalogServer) OUt-LogFile -string ("Parameter Set:") foreach ($parameterIncluded in $parameterSet) { Out-Logfile -string $parameterIncluded } out-logfile -string ("Credential user name = "+$adCredential.UserName) #Get the group using LDAP / AD providers. try { Out-LogFile -string "Using AD / LDAP provider to get original DL configuration" if ($groupSMTPAddress -ne "None") { out-logfile -string ("Searching by mail address "+$groupSMTPAddress) out-logfile -string ("Imported Address Length: "+$groupsmtpAddress.length.toString()) #Ensure that there are no spaces contained in the string (account for import errors.) out-logfile -string ("Spaces Removed Address Length: "+$groupsmtpAddress.length.toString()) $functionDLConfiguration=Get-ADObject -filter "mail -eq `"$groupSMTPAddress`"" -properties $parameterSet -server $globalCatalogServer -credential $adCredential -errorAction STOP } elseif ($DN -ne "None") { out-logfile -string ("Searching by distinguished name "+$dn) $functionDLConfiguration=get-adObject -identity $DN -properties $parameterSet -server $globalCatalogServer -credential $adCredential -errorAction STOP } else { out-logfile -string "No value query found for local object." -isError:$TRUE } #If the ad provider command cannot find the group - the variable is NULL. An error is not thrown. if (($functionDLConfiguration -eq $NULL) -and ($isValidTest -eq $FALSE)) { throw "The group cannot be found in Active Directory by email address." } elseif (($functionDLConfiguration -eq $NULL) -and ($isValidTest -eq $TRUE)) { out-logfile -string "Function called to validate recipient - not found." out-logfile -string "Returning as this is not an error in this function" } Out-LogFile -string "Original DL configuration found and recorded." } catch { Out-LogFile -string $_ -isError:$TRUE } Out-LogFile -string "END Get-ADObjectConfiguration" Out-LogFile -string "********************************************************************************" #This function is designed to open local and remote powershell sessions. #If the session requires import - for example exchange - return the session for later work. #If not no return is required. if ($functionDLConfiguration.count -gt 0) { out-logfile -string "Multiple active directory objects were detected with the same mail address property." foreach ($object in $functionDLConfiguration) { out-logfile -string "==========" out-logfile -string $object.distinguishedName out-logfile -string $object.mail out-logfile -string "==========" } out-logfile -string "Administrator action required - the previous objects have the same windows mail address." out-logfile -string "Please correct the duplicate mail addresses so that only the distribution list has the mail address." out-logfile -string "" -isError:$TRUE } else { out-logfile -string "Single object detected - returning DL configuration." } if ($functionDLConfiguration -ne $NULL) { return $functionDLConfiguration } } |