Merge pull request KelvinTegelaar#1431 from kris6673/feat-max-email-size

Feat: Add action to set max send/receive size for mailboxes

Author: KelvinTegelaar

Modules/CIPPCore/Public/Entrypoints/HTTP Functions/Email-Exchange/Administration/Invoke-ExecSetMailboxEmailSize.ps1

@@ -0,0 +1,49 @@
+using namespace System.Net
+
+Function Invoke-ExecSetMailboxEmailSize {
+    <#
+    .FUNCTIONALITY
+        Entrypoint
+    .ROLE
+        Exchange.Mailbox.ReadWrite
+    #>
+    [CmdletBinding()]
+    param($Request, $TriggerMetadata)
+
+    $APIName = $Request.Params.CIPPEndpoint
+    $Headers = $Request.Headers
+    Write-LogMessage -Headers $User -API $APIName -message 'Accessed this API' -Sev 'Debug'
+
+    # Interact with query parameters or the body of the request.
+    $Tenant = $Request.Body.tenantFilter
+    $UserPrincipalName = $Request.Body.UPN
+    $UserID = $Request.Body.id
+    $MaxSendSize = $Request.Body.maxSendSize
+    $MaxReceiveSize = $Request.Body.maxReceiveSize
+
+    try {
+        $Params = @{
+            TenantFilter      = $Tenant
+            APIName           = $APIName
+            Headers           = $Headers
+            UserPrincipalName = $UserPrincipalName
+            UserID            = $UserID
+            MaxSendSize       = $MaxSendSize
+            MaxReceiveSize    = $MaxReceiveSize
+        }
+        if ([string]::IsNullOrWhiteSpace($MaxSendSize)) { $Params.Remove('MaxSendSize') }
+        if ([string]::IsNullOrWhiteSpace($MaxReceiveSize)) { $Params.Remove('MaxReceiveSize') }
+        $Result = Set-CippMaxEmailSize @Params
+        $StatusCode = [HttpStatusCode]::OK
+    } catch {
+        $Result = "$($_.Exception.Message)"
+        $StatusCode = [HttpStatusCode]::InternalServerError
+    }
+
+    # Associate values to output bindings by calling 'Push-OutputBinding'.
+    Push-OutputBinding -Name Response -Value ([HttpResponseContext]@{
+            StatusCode = $StatusCode
+            Body       = @{ Results = $Result }
+        })
+
+}

Modules/CIPPCore/Public/Set-CippMaxEmailSize.ps1

@@ -0,0 +1,57 @@
+function Set-CippMaxEmailSize {
+    [CmdletBinding()]
+    param (
+        $Headers,
+        $TenantFilter,
+        $APIName = 'Mailbox Max Send/Receive Size',
+        $UserPrincipalName,
+        $UserID,
+        [ValidateRange(1, 150)]
+        [Int32]$MaxSendSize,
+        [ValidateRange(1, 150)]
+        [Int32]$MaxReceiveSize
+    )
+
+    try {
+        # Id the ID is provided, use it. Otherwise, use the UPN
+        $Identity = $UserID ?? $UserPrincipalName
+        if ([string]::IsNullOrWhiteSpace($Identity)) {
+            $Result = 'No identity provided. Cannot set mailbox email max size.'
+            Write-LogMessage -headers $Headers -API $APIName -message $Result -Sev Error -tenant $TenantFilter
+            throw $Result
+        }
+
+        if ($MaxSendSize -eq 0 -and $MaxReceiveSize -eq 0) {
+            $Result = 'No max send or receive size provided. Cannot set mailbox email max size.'
+            Write-LogMessage -headers $Headers -API $APIName -message $Result -Sev Error -tenant $TenantFilter
+            throw $Result
+        }
+
+        $cmdletParams = @{
+            Identity = $Identity
+        }
+        # Set the max send and receive size if they are provided. Convert to bytes
+        if ($MaxSendSize -gt 0) { $cmdletParams['MaxSendSize'] = $MaxSendSize * 1MB }
+        if ($MaxReceiveSize -gt 0) { $cmdletParams['MaxReceiveSize'] = $MaxReceiveSize * 1MB }
+
+        $null = New-ExoRequest -tenantid $TenantFilter -cmdlet 'Set-Mailbox' -cmdParams $cmdletParams
+
+        # Use UPN for logging if provided
+        $Identity = $UserPrincipalName ?? $UserID
+        $Result = "Set mailbox email max size for $($Identity) to "
+        if ($MaxSendSize -gt 0) { $Result += "Send: $($MaxSendSize)MB " }
+        if ($MaxReceiveSize -gt 0) { $Result += "Receive: $($MaxReceiveSize)MB" }
+
+        Write-LogMessage -headers $Headers -API $APIName -message $Result -Sev Info -tenant $TenantFilter
+        return $Result
+    } catch {
+        $ErrorMessage = Get-CippException -Exception $_
+
+        # Use UPN for logging if provided
+        $Identity = $UserPrincipalName ?? $UserID
+        $Result = "Failed to set mailbox email max size for $($Identity). Error: $($ErrorMessage)"
+
+        Write-LogMessage -headers $Headers -API $APIName -message $Result -Sev Error -tenant $TenantFilter -LogData $ErrorMessage
+        throw $Result
+    }
+}