Get-O365DLMailboxFolderPermissions.ps1
|
<#
.SYNOPSIS This function uses the exchange online powershell session to gather the office 365 distribution list configuration. .DESCRIPTION This function uses the exchange online powershell session to gather the office 365 distribution list configuration. .PARAMETER GroupSMTPAddress The mail attribute of the group to search. .OUTPUTS Returns the PS object associated with the recipient from get-o365recipient .EXAMPLE Get-O365DLFullMaiboxAccess -groupSMTPAddress Address #> Function Get-O365DLMailboxFolderPermissions { [cmdletbinding()] Param ( [Parameter(Mandatory = $true)] [string]$groupSMTPAddress, [Parameter(Mandatory = $false)] $collectedData=$NULL ) #Declare function variables. [array]$functionFolderAccess=@() #Start function processing. Out-LogFile -string "********************************************************************************" Out-LogFile -string "BEGIN Get-O365DLMailboxFolderPermissions" Out-LogFile -string "********************************************************************************" #Log the parameters and variables for the function. Out-LogFile -string ("GroupSMTPAddress = "+$groupSMTPAddress) #Get the recipient using the exchange online powershell session. if ($collectedData -eq $NULL) { out-logfile -string "No folder permissions were provided for evaluation." } elseif ($collectedData -ne $NULL) { $ProgressDelta = 100/($collectedData.count); $PercentComplete = 0; $MbxNumber = 0 out-logfile -string "Processing folder permissions for imported data." foreach ($folder in $collectedData) { $MbxNumber++ write-progress -activity "Processing Recipient" -status $folder.identity -PercentComplete $PercentComplete $PercentComplete += $ProgressDelta if ($folder.user.tostring() -eq $groupSMTPAddress ) { $functionFolderAccess+=$folder } } } write-progress -activity "Processing Recipient" -completed Out-LogFile -string "END Get-O365DLMailboxFolderPermissions" Out-LogFile -string "********************************************************************************" if ($functionFolderAccess.count -gt 0) { return $functionFolderAccess } } |