Clear-EWSFolder.ps1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
function Clear-EWSFolder {
    [CmdletBinding(
        SupportsShouldProcess,
        ConfirmImpact = 'High'
    )]
    param (
        [Microsoft.Exchange.WebServices.Data.DeleteMode]$DeleteMode = 'MoveToDeletedItems',

        [Parameter(
            ValueFromPipelineByPropertyName
        )]
        [Microsoft.Exchange.WebServices.Data.ExchangeService]$Service = $Script:exchangeService,
        
        [Parameter(
            ValueFromPipeline,
            Mandatory
        )]
        [Microsoft.Exchange.WebServices.Data.Folder]$Folder,
        
        [switch]$IncludeSubfolders
    )

    process {
        if (-not $Service) {
            return
        }
        if ($PSCmdlet.ShouldProcess(
            "Folder: $($Folder.DisplayName)",
            "Clear (empty) EWS Folder with$('out' * (-not $IncludeSubfolders)) subfolders"
        )) {
            $Folder.Empty($DeleteMode, $IncludeSubfolders)
        }
    }

    end {
        if (-not $Service) {
            Write-Warning 'No connection defined. Use Connect-EWSService first!'
            return
        }
    }
}