Get-EXOMailboxFolderPermission

Exchange Online Management: Gets folder-level permissions in mailboxes

Script

#Requires -Version 5.1

[CmdletBinding()]
Param(
    [Parameter(Mandatory = $true)]
    [string]$Identity,
    [Parameter(Mandatory = $true)]
    [string]$FolderName,
    [switch]$GroupMailbox,
    [string]$User
)

Process {
    try {
        [hashtable]$cmdArgs = @{'ErrorAction' = 'Stop'; 'Identity' = "$($Identity):\$($FolderName)"; 'GroupMailbox' = $GroupMailbox}

        if ($PSBoundParameters.ContainsKey('User')) {
            $cmdArgs.Add('User', $User)
        }

        $result = Get-EXOMailboxFolderPermission @cmdArgs | Select-Object *
        if ($null -eq $result -or $result.Count -eq 0) {
            Write-Output "No folder permissions found"
            return
        }
        foreach ($item in $result) {
            $item | Add-Member -NotePropertyName Timestamp -NotePropertyValue (Get-Date -Format "yyyy-MM-dd HH:mm:ss") -PassThru -Force
        }
    }
    catch { throw }
}

Customize

Identity string

Name, Alias or SamAccountName of the mailbox

FolderName string

The mailbox folder to view permissions for

GroupMailbox switch

Off

Required to return Microsoft 365 Groups in the results

User string

Filters results by the user granted permission to the mailbox folder (Name, Alias or Guid)