functions/Get-DryADOUPathFromAlias.ps1

<#
    This is an AD Config module for use with DryDeploy, or by itself.
    Copyright (C) 2021 Bjørn Henrik Formo (bjornhenrikformo@gmail.com)
    LICENSE: https://raw.githubusercontent.com/bjoernf73/dry.module.ad/main/LICENSE
 
    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.
 
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    GNU General Public License for more details.
 
    You should have received a copy of the GNU General Public License along
    with this program; if not, write to the Free Software Foundation, Inc.,
    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
#>

function Get-DryADOUPathFromAlias {
    [cmdletbinding()]
    param (
        [Parameter(Mandatory)]
        [string]$Alias,

        [Parameter(Mandatory)]
        [Array]$OUs
    )

    $ReferencedOU = $OUs | Where-Object {  
        $_.Alias -eq $Alias
    }
    olad d 'Alias', "$Alias"

    if ($null -eq $ReferencedOU) {
        olad e @('Unable to resolve OU from Alias', 'No OUs found')
        throw "Unable to find OU for Alias '$Alias': No references found"
    } 

    if ($ReferencedOU -is [Array]) {
        olad e @('Unable to resolve OU from Alias', 'Multiple OUs found')
        throw "Unable to find single OU for Alias '$Alias': Multiple references found"
    }
    
    $Path = $ReferencedOU.Path
    if ($null -eq $Path) {
        olad e "Found OU '$($OU.Alias)', but it contains no path"
        throw "Found OU '$($OU.Alias)', but it contains no path"
    }

    olad v @("Alias '$Alias'", "$Path")
    $Path
}