get-OULocation.ps1

<#
    .SYNOPSIS

    This function calculates the correct OU to place an object.

    .DESCRIPTION

    This function calculates the correct OU to place an object.

    .PARAMETER originalDLConfiguration

    The mail attribute of the group to search.

    .OUTPUTS

    Returns the organizational unit where the object should be stored.

    .EXAMPLE

    get-OULocation -originalDLConfiguration $originalDLConfiguration

    #>

    Function Get-OULocation
     {
        [cmdletbinding()]

        Param
        (
            [Parameter(Mandatory = $true)]
            $originalDLConfiguration
        )

        #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)

        Out-LogFile -string "********************************************************************************"
        Out-LogFile -string "BEGIN Get-OULocation"
        Out-LogFile -string "********************************************************************************"

        #Declare function variables.

        [string]$returnOU=$NULL

        #Test to see if the DN contains an OU.

        out-logfile -string $originalDLConfiguration.distinguishedname

        $testOUSubstringLocation = $originalDLConfiguration.distinguishedName.indexof(",OU=")
        out-logfile -string ("The location of ,OU= is:"+$testOUSubstringLocation)

        if ($testOUSubStringLocation -ge 0)
        {
            out-logfile -string "The group is in an organizational unit."
            out-logfile -string $testOUSubstringLocation.tostring()
            $tempOUSubstring = $originalDLConfiguration.distinguishedname.substring($testOUSubstringLocation)
            out-logfile -string "Temp OU Substring = "
            out-logfile -string $tempOUSubstring
            $testOUSubstringLocation = $tempOUSubstring.indexof("OU=")
            out-logfile -string $testOUSubstringLocation.tostring()
            $tempOUSubstring = $tempOUSubstring.substring($testOUSubstringLocation)
            out-logfile -string "Temp OU Substring Substring ="
            out-logfile -string $tempOUSubstring
        }
        else 
        {
            out-logfile -string "The group is in a container and not an OU."
            $testOUSubstringLocation = $originalDLConfiguration.distinguishedName.indexof(",CN=")    
            out-logfile -string $testOUSubstringLocation.tostring()
            $tempOUSubstring = $originalDLConfiguration.distinguishedname.substring($testOUSubstringLocation)
            out-logfile -string "Temp OU Substring = "
            out-logfile -string $tempOUSubstring
            $testOUSubstringLocation = $tempOUSubstring.indexof("CN=")
            out-logfile -string $testOUSubstringLocation.tostring()
            $tempOUSubstring = $tempOUSubstring.substring($testOUSubstringLocation)
            out-logfile -string "Temp OU Substring Substring ="
            out-logfile -string $tempOUSubstring
        }

        $returnOU = $tempOUSubstring

        Out-LogFile -string "********************************************************************************"
        Out-LogFile -string "END Get-OULocation"
        Out-LogFile -string "********************************************************************************"

        return $returnOU
     }