Public/Get-Quarantine.ps1
|
Function Get-Quarantine { <# .DESCRIPTION This is an alternative to the function Get-QuarantineMessage. This function bypasses the 1000 item per page limit by creating an array of results for up to 1000 pages and 1 million results. That is the log limit applied by Microsoft. I recommend limiting results as much as possible for performance reasons. Use Get-QuarantineMessage to restrict results further. .EXAMPLE Specify the number of pages with 1000 results to return Get-Quarantine -pages 15 .EXAMPLE Return the default of 1 page with up to 1000 results Get-Quarantine .EXAMPLE Specify the pagesize to limit output to only x number of results Get-Quarantine -pagesize 15 .NOTES Requires the ExchangeOnline module be installed, imported, and Connected. .LINK Get-QuarantineMessage Release-QuarantineMessage Unblock-Quarantine Export-QuarantineMessage Export-Quarantine #> [CmdletBinding()] Param ( [Parameter(Mandatory = $false)][ValidateRange(1, 1000)][int]$pages = 1, [Parameter(Mandatory = $false)][ValidateRange(1, 1000)][int]$pagesize = 1000 ) #Takes results from all pages and loads them into an array for presenting more than 1 page of results at once $array = foreach ($number in 1..$pages) { Get-QuarantineMessage -page $number -Pagesize $pagesize | Select-Object * } $array } |