Get-O365DLSendAs.ps1

<#
    .SYNOPSIS

    This function gathers all Office 365 Send as permissions for the migrated DLs.

    .DESCRIPTION

    This function gathers all Office 365 Send as permissions for the migrated DLs.

    .PARAMETER GroupSMTPAddress

    The mail attribute of the group to search.

    .PARAMETER isTrustee

    Determines if we're searching for permissions on the group itself or permissions for the migrated DL on other objects.

    .OUTPUTS

    Returns either send as permissions on the migrated DL or all objects that the migrated DL has send as permissions on.

    .EXAMPLE

    Get-O365DLSendAs -groupSMTPAddress Address -isTrustee:$TRUE

    #>
    Function Get-O365DLSendAs
     {
        [cmdletbinding()]

        Param
        (
            [Parameter(Mandatory = $true)]
            [string]$groupSMTPAddress,
            [Parameter(Mandatory = $false)]
            [string]$isTrustee=$FALSE,
            [Parameter(Mandatory = $false)]
            $office365GroupConfiguration
        )

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

        [array]$functionSendAs=@()

        #Start function processing.

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

        #Get the recipient using the exchange online powershell session.

        if ($isTrustee -eq $TRUE)
        {
            try 
            {
                Out-LogFile -string "Obtaining all Office 365 groups the migrated DL has send as permissions on."

                $functionSendAs = get-o365RecipientPermission -Trustee $groupSMTPAddress -resultsize unlimited -errorAction STOP
            }
            catch 
            {
                Out-LogFile -string $_ -isError:$TRUE
            }

            <#

            out-logfile -string "Determining if the group has permissions to itself and excluding it from the array."
            out-logfile -string ("PreCount: "+$functionSendAs.Count)

            $functionSendAs = $functionSendAs | where {$_.TrusteeSidString -ne $office365GroupConfiguration.SID}

            out-logfile -string ("PostCount: "+$functionSendAs.Count)
            
            #>
        }
        else
        {
            try
            {
                out-logfile -string "Obtaining all send as permissions set directly in Office 365 on the group to be migrated."

                $functionSendAs = get-O365RecipientPermission -identity $groupSMTPAddress -resultsize unlimited -errorAction STOP

                out-logfile -string ("Number of send as located: "+$functionSendAs.Count)
            }
            catch
            {
                out-logfile -string $_ -isError:$TRUE
            }
        }
        
        Out-LogFile -string "END Get-O365DLSendAs"
        Out-LogFile -string "********************************************************************************"
        
        return $functionSendAs
    }