FEAT: Add support for auto-expanding archive in mailbox management

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

@@ -0,0 +1,37 @@
+using namespace System.Net
+
+Function Invoke-ExecEnableArchive {
+    <#
+    .FUNCTIONALITY
+        Entrypoint
+    .ROLE
+        Exchange.Mailbox.ReadWrite
+    #>
+    [CmdletBinding()]
+    param($Request, $TriggerMetadata)
+
+    $APIName = $Request.Params.CIPPEndpoint
+    $Headers = $Request.Headers
+    Write-LogMessage -headers $Headers -API $APIName -message 'Accessed this API' -Sev 'Debug'
+
+    # Interact with query parameters or the body of the request.
+    $TenantFilter = $Request.Query.tenantFilter ?? $Request.Body.tenantFilter
+    $ID = $Request.Query.id ?? $Request.Body.id
+    $UserName = $Request.Query.username ?? $Request.Body.username
+
+    Try {
+        $ResultsArch = Set-CIPPMailboxArchive -userid $ID -tenantFilter $TenantFilter -APIName $APIName -Headers $Headers -ArchiveEnabled $true -Username $UserName
+        if ($ResultsArch -like 'Failed to set archive*') { throw $ResultsArch }
+        $StatusCode = [HttpStatusCode]::OK
+    } catch {
+        $ResultsArch = $_.Exception.Message
+        $StatusCode = [HttpStatusCode]::InternalServerError
+    }
+    $Results = [pscustomobject]@{'Results' = "$ResultsArch" }
+    # Associate values to output bindings by calling 'Push-OutputBinding'.
+    Push-OutputBinding -Name Response -Value ([HttpResponseContext]@{
+            StatusCode = $StatusCode
+            Body       = $Results
+        })
+
+}

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

@@ -0,0 +1,32 @@
+function Invoke-ExecEnableAutoExpandingArchive {
+    <#
+    .FUNCTIONALITY
+        Entrypoint
+    .ROLE
+        Exchange.Mailbox.ReadWrite
+    #>
+    [CmdletBinding()]
+    param($Request, $TriggerMetadata)
+
+    $APIName = $Request.Params.CIPPEndpoint
+    $Headers = $Request.Headers
+    Write-LogMessage -headers $Headers -API $APIName -message 'Accessed this API' -Sev 'Debug'
+
+    # Interact with query parameters or the body of the request.
+    $ID = $Request.Body.ID
+    $TenantFilter = $Request.Body.tenantFilter
+    $Username = $Request.Body.username
+
+    try {
+        $Result = Set-CIPPMailboxArchive -TenantFilter $TenantFilter -UserID $ID -Username $Username -Headers $Headers -AutoExpandingArchive
+        $StatusCode = [HttpStatusCode]::OK
+    } catch {
+        $Result = $_.Exception.Message
+        $StatusCode = [HttpStatusCode]::InternalServerError
+    }
+
+    Push-OutputBinding -Name Response -Value ([HttpResponseContext]@{
+            StatusCode = $StatusCode
+            Body       = @{Results = "$Result" }
+        })
+}

Modules/CIPPCore/Public/Set-CIPPMailboxArchive.ps1

@@ -6,19 +6,27 @@ function Set-CIPPMailboxArchive {
         $Username,
         $APIName = 'Mailbox Archive',
         $TenantFilter,
-        [bool]$ArchiveEnabled
+        [bool]$ArchiveEnabled,
+        [switch]$AutoExpandingArchive
     )
 
     try {
-        if (!$Username) { $Username = $UserID }
-        $null = New-ExoRequest -tenantid $TenantFilter -cmdlet 'Enable-Mailbox' -cmdParams @{Identity = $UserID; Archive = $ArchiveEnabled }
-        $Message = "Successfully set archive for $Username to $ArchiveEnabled"
-        Write-LogMessage -Headers $Headers -API $APINAME -tenant $TenantFilter -message $Message -Sev 'Info'
+        if ([string]::IsNullOrWhiteSpace($Username)) { $Username = $UserID }
+        $OperationType = if ($AutoExpandingArchive.IsPresent -eq $true) { 'auto-expanding archive' } else { 'archive' }
+        if ($AutoExpandingArchive.IsPresent -eq $true) {
+            $null = New-ExoRequest -tenantid $TenantFilter -cmdlet 'Enable-Mailbox' -cmdParams @{Identity = $UserID; AutoExpandingArchive = $true }
+            $Message = "Successfully enabled $OperationType for $Username"
+        } else {
+            $null = New-ExoRequest -tenantid $TenantFilter -cmdlet 'Enable-Mailbox' -cmdParams @{Identity = $UserID; Archive = $ArchiveEnabled }
+            $Message = "Successfully set $OperationType for $Username to $ArchiveEnabled"
+        }
+
+        Write-LogMessage -Headers $Headers -API $APIName -tenant $TenantFilter -message $Message -Sev 'Info'
         return $Message
     } catch {
         $ErrorMessage = Get-CippException -Exception $_
-        $Message = "Failed to set archive for $Username. Error: $($ErrorMessage.NormalizedError)"
-        Write-LogMessage -Headers $Headers -API $APINAME -tenant $TenantFilter -message $Message -Sev 'Error' -LogData $ErrorMessage
-        return $Message
+        $Message = "Failed to set $OperationType for $Username. Error: $($ErrorMessage.NormalizedError)"
+        Write-LogMessage -Headers $Headers -API $APIName -tenant $TenantFilter -message $Message -Sev 'Error' -LogData $ErrorMessage
+        throw $Message
     }
 }