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
        }
    }