Get-O365DLFullMaiboxAccess.ps1

<#
    .SYNOPSIS

    This function searches the collected data for all Office 365 full mailbox access permissions.

    .DESCRIPTION

     This function searches the collected data for all Office 365 full mailbox access permissions.

    .PARAMETER GroupSMTPAddress

    The mail attribute of the group to search.

    .PARAMETER collectedData

    The precollected data utilized for evaluation.

    .OUTPUTS

    Returns all full mailbox access permissions for the migrated group.

    .EXAMPLE

    Get-O365DLFullMaiboxAccess -groupSMTPAddress Address -collectedData DataArray

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

        Param
        (
            [Parameter(Mandatory = $true)]
            [string]$groupSMTPAddress,
            [Parameter(Mandatory = $false)]
            $collectedData=$NULL
        )

        #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]$functionFullMailboxAccess=@()
        $functionMailboxes=$NULL
        $functionRecipient=$NULL

        #Start function processing.

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

        #Get the recipient using the exchange online powershell session.

        if ($collectedData -eq $NULL)
        {
            <# This is no longer utilized since live collection is not supported.  Retaining.
            try {
                out-logfile -string "Getting recipient..."
    
                #$functionRecipient = get-ExoRecipient -identity $groupSMTPAddress
                $functionRecipient = get-o365Recipient -identity $groupSMTPAddress
            }
            catch {
                out-logfile -string $_ -isError:$TRUE
            }
    
            #Get all of the mailboxes to test.
    
            try {
                out-logfile -string "Getting all Office 365 mailboxes."
    
                #$functionMailboxes = get-exomailbox -resultsize unlimited
                $functionMailboxes = get-o365mailbox -resultsize unlimited
            }
            catch {
                out-logfile -string $_ -isError:$TRUE
            }
            
            try 
            {
                Out-LogFile -string "Using Exchange Online to locate all of the full mailbox access rights in Office 365."
    
                $ProgressDelta = 100/($functionMailboxes.count); $PercentComplete = 0; $MbxNumber = 0
    
                foreach ($mailbox in $functionMailboxes)
                {
                    $MbxNumber++
    
                    write-progress -activity "Processing Recipient" -status $mailbox.primarySMTPAddress -PercentComplete $PercentComplete
    
                    $PercentComplete += $ProgressDelta
    
                    #$functionFullMailboxAccess+=get-exoMailboxPermission -identity $mailbox.identity | where {$_.user -eq $functionRecipient.identity}
                    $functionFullMailboxAccess+=get-o365MailboxPermission -identity $mailbox.identity | where {$_.user -eq $functionRecipient.identity}
                }
            }
            catch 
            {
                Out-LogFile -string $_ -isError:$TRUE
            }
    
            write-progress -activity "Processing Recipient" -completed

            #>
        }
        elseif ($collectedData -ne $NULL)
        {
            try {
                out-logfile -string "Getting recipient..."
    
                #$functionRecipient = get-ExoRecipient -identity $groupSMTPAddress
                $functionRecipient = get-o365Group -identity $groupSMTPAddress
            }
            catch {
                out-logfile -string $_ -isError:$TRUE
            }

            out-logfile "Obtaining all full mailbox access permissions in Office 365."

            $functionFullMailboxAccess = $collectedData | where {$_.usersid -eq $functionRecipient.sid}
        }

        Out-LogFile -string "END Get-O365DLFullMaiboxAccess"
        Out-LogFile -string "********************************************************************************"
        
        if ($functionFullMailboxAccess.count -gt 0)
        {
            return $functionFullMailboxAccess
        }
    }