Merge pull request KelvinTegelaar#1591 from kris6673/issue4538

Feat: Add SendNotificationToUser parameter to calendar permission functions

Author: KelvinTegelaar

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

@@ -1,6 +1,6 @@
 using namespace System.Net
 
-Function Invoke-ExecModifyCalPerms {
+function Invoke-ExecModifyCalPerms {
     <#
     .FUNCTIONALITY
         Entrypoint
@@ -64,6 +64,7 @@ Function Invoke-ExecModifyCalPerms {
         $Modification = $Permission.Modification
         $CanViewPrivateItems = $Permission.CanViewPrivateItems ?? $false
         $FolderName = $Permission.FolderName ?? 'Calendar'
+        $SendNotificationToUser = $Permission.SendNotificationToUser ?? $false
 
         Write-LogMessage -headers $Headers -API $APIName -message "Permission Level: $PermissionLevel, Modification: $Modification, CanViewPrivateItems: $CanViewPrivateItems, FolderName: $FolderName" -Sev 'Debug'
 
@@ -76,16 +77,17 @@ Function Invoke-ExecModifyCalPerms {
             try {
                 Write-LogMessage -headers $Headers -API $APIName -message "Processing target user: $TargetUser" -Sev 'Debug'
                 $Params = @{
-                    APIName              = $APIName
-                    Headers              = $Headers
-                    RemoveAccess         = if ($Modification -eq 'Remove') { $TargetUser } else { $null }
-                    TenantFilter         = $TenantFilter
-                    UserID               = $UserId
-                    folderName           = $FolderName
-                    UserToGetPermissions = $TargetUser
-                    LoggingName          = $TargetUser
-                    Permissions          = $PermissionLevel
-                    CanViewPrivateItems  = $CanViewPrivateItems
+                    APIName                = $APIName
+                    Headers                = $Headers
+                    RemoveAccess           = if ($Modification -eq 'Remove') { $TargetUser } else { $null }
+                    TenantFilter           = $TenantFilter
+                    UserID                 = $UserId
+                    folderName             = $FolderName
+                    UserToGetPermissions   = $TargetUser
+                    LoggingName            = $TargetUser
+                    Permissions            = $PermissionLevel
+                    CanViewPrivateItems    = $CanViewPrivateItems
+                    SendNotificationToUser = $SendNotificationToUser
                 }
 
                 # Write-Host "Request params: $($Params | ConvertTo-Json)"

Modules/CIPPCore/Public/Set-CIPPCalendarPermission.ps1

@@ -6,15 +6,15 @@ function Set-CIPPCalendarPermission {
         $RemoveAccess,
         $TenantFilter,
         $UserID,
-        $folderName,
+        $FolderName,
         $UserToGetPermissions,
         $LoggingName,
         $Permissions,
-        [bool]$CanViewPrivateItems
+        [bool]$CanViewPrivateItems,
+        [bool]$SendNotificationToUser = $false
     )
 
     try {
-
         # If a pretty logging name is not provided, use the ID instead
         if ([string]::IsNullOrWhiteSpace($LoggingName) -and $RemoveAccess) {
             $LoggingName = $RemoveAccess
@@ -23,33 +23,37 @@ function Set-CIPPCalendarPermission {
         }
 
         $CalParam = [PSCustomObject]@{
-            Identity     = "$($UserID):\$folderName"
-            AccessRights = @($Permissions)
-            User         = $UserToGetPermissions
+            Identity               = "$($UserID):\$FolderName"
+            AccessRights           = @($Permissions)
+            User                   = $UserToGetPermissions
+            SendNotificationToUser = $SendNotificationToUser
         }
 
         if ($CanViewPrivateItems) {
             $CalParam | Add-Member -NotePropertyName 'SharingPermissionFlags' -NotePropertyValue 'Delegate,CanViewPrivateItems'
         }
-        
+
         if ($RemoveAccess) {
-            if ($PSCmdlet.ShouldProcess("$UserID\$folderName", "Remove permissions for $LoggingName")) {
-                $null = New-ExoRequest -tenantid $TenantFilter -cmdlet 'Remove-MailboxFolderPermission' -cmdParams @{Identity = "$($UserID):\$folderName"; User = $RemoveAccess }
+            if ($PSCmdlet.ShouldProcess("$UserID\$FolderName", "Remove permissions for $LoggingName")) {
+                $null = New-ExoRequest -tenantid $TenantFilter -cmdlet 'Remove-MailboxFolderPermission' -cmdParams @{Identity = "$($UserID):\$FolderName"; User = $RemoveAccess }
                 $Result = "Successfully removed access for $LoggingName from calendar $($CalParam.Identity)"
                 Write-LogMessage -headers $Headers -API $APIName -tenant $TenantFilter -message $Result -sev Info
             }
         } else {
-            if ($PSCmdlet.ShouldProcess("$UserID\$folderName", "Set permissions for $LoggingName to $Permissions")) {
+            if ($PSCmdlet.ShouldProcess("$UserID\$FolderName", "Set permissions for $LoggingName to $Permissions")) {
                 try {
                     $null = New-ExoRequest -tenantid $TenantFilter -cmdlet 'Set-MailboxFolderPermission' -cmdParams $CalParam -Anchor $UserID
                 } catch {
                     $null = New-ExoRequest -tenantid $TenantFilter -cmdlet 'Add-MailboxFolderPermission' -cmdParams $CalParam -Anchor $UserID
                 }
-                Write-LogMessage -headers $Headers -API $APIName -tenant $TenantFilter -message "Successfully set Calendar permissions $Permissions for $LoggingName on $UserID." -sev Info
                 $Result = "Successfully set permissions on folder $($CalParam.Identity). The user $LoggingName now has $Permissions permissions on this folder."
                 if ($CanViewPrivateItems) {
-                    $Result += " The user can also view private items."
+                    $Result += ' The user can also view private items.'
                 }
+                if ($SendNotificationToUser) {
+                    $Result += ' A notification has been sent to the user.'
+                }
+                Write-LogMessage -headers $Headers -API $APIName -tenant $TenantFilter -message $Result -sev Info
             }
         }
     } catch {