[pull] dev from KelvinTegelaar:dev

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Core/Invoke-ListAdminPortalLicenses.ps1

@@ -4,6 +4,8 @@ function Invoke-ListAdminPortalLicenses {
         Entrypoint
     .ROLE
         CIPP.Core.Read
+    .DESCRIPTION
+        Retrieves license information from the Microsoft 365 Admin Portal for a tenant, including low-friction trial allotments.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Core/Invoke-ListApiTest.ps1

@@ -4,6 +4,8 @@ function Invoke-ListApiTest {
         Entrypoint,AnyTenant
     .ROLE
         CIPP.Core.Read
+    .DESCRIPTION
+        Returns debug information about the current API request, trigger metadata, and environment variables. Used for CIPP platform diagnostics.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Core/Invoke-ListCustomDataMappings.ps1

@@ -4,6 +4,8 @@ function Invoke-ListCustomDataMappings {
         Entrypoint
     .ROLE
         CIPP.Core.Read
+    .DESCRIPTION
+        Lists custom data mappings that define how external data sources map to CIPP directory objects, filterable by source type, directory object, and tenant.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Core/Invoke-ListDiagnosticsPresets.ps1

@@ -4,6 +4,8 @@ function Invoke-ListDiagnosticsPresets {
         Entrypoint
     .ROLE
         CIPP.SuperAdmin.Read
+    .DESCRIPTION
+        Lists saved diagnostics presets used for troubleshooting CIPP configuration. Requires SuperAdmin access.
     #>
     [CmdletBinding()]
     param (

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Core/Invoke-ListDirectoryObjects.ps1

@@ -4,6 +4,8 @@ function Invoke-ListDirectoryObjects {
         Entrypoint,AnyTenant
     .ROLE
         CIPP.Core.Read
+    .DESCRIPTION
+        Resolves Entra ID directory objects by their IDs using the directoryObjects/getByIds batch endpoint. Accepts an array of object IDs in the request body.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Core/Invoke-ListFeatureFlags.ps1

@@ -4,6 +4,8 @@ function Invoke-ListFeatureFlags {
         Entrypoint
     .ROLE
         CIPP.Core.Read
+    .DESCRIPTION
+        Lists CIPP feature flags and their enabled/disabled state, including environment-driven overrides.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Core/Invoke-ListGraphBulkRequest.ps1

@@ -4,6 +4,8 @@ function Invoke-ListGraphBulkRequest {
         Entrypoint
     .ROLE
         CIPP.Core.Read
+    .DESCRIPTION
+        Executes multiple Microsoft Graph API requests in a single batch call for a given tenant. Accepts an array of request objects in the body.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Core/Invoke-ListGraphRequest.ps1

@@ -5,6 +5,8 @@ function Invoke-ListGraphRequest {
         Entrypoint
     .ROLE
         CIPP.Core.Read
+    .DESCRIPTION
+        Proxies an arbitrary Microsoft Graph API GET request for a tenant. Supports custom endpoints, filters, pagination, and field selection via query parameters.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Core/Invoke-ListSnoozedAlerts.ps1

@@ -4,6 +4,8 @@ function Invoke-ListSnoozedAlerts {
         Entrypoint,AnyTenant
     .ROLE
         CIPP.Alert.Read
+    .DESCRIPTION
+        Lists alerts that have been snoozed (temporarily suppressed), filterable by cmdlet name. Returns snooze duration and scope details.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Core/invoke-ListEmptyResults.ps1

@@ -8,6 +8,8 @@ function invoke-ListEmptyResults {
         Entrypoint,AnyTenant
     .ROLE
         CIPP.Core.Read
+    .DESCRIPTION
+        Returns an empty results array. Used as a placeholder endpoint.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Extensions/Invoke-ListExtensionSync.ps1

@@ -4,6 +4,8 @@ Function Invoke-ListExtensionSync {
         Entrypoint,AnyTenant
     .ROLE
         CIPP.Extension.Read
+    .DESCRIPTION
+        Lists extension synchronization tasks and their status, including last sync results for configured third-party integrations (Hudu, Halo, NinjaOne, etc.).
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Scheduler/Invoke-ListScheduledItemDetails.ps1

@@ -4,6 +4,8 @@ function Invoke-ListScheduledItemDetails {
         Entrypoint,AnyTenant
     .ROLE
         CIPP.Scheduler.Read
+    .DESCRIPTION
+        Retrieves detailed information about a specific scheduled task by its RowKey, including execution results and task parameters.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Scheduler/Invoke-ListScheduledItems.ps1

@@ -4,6 +4,8 @@ function Invoke-ListScheduledItems {
         Entrypoint,AnyTenant
     .ROLE
         CIPP.Scheduler.Read
+    .DESCRIPTION
+        Lists scheduled tasks in CIPP, filterable by tenant or task ID. Returns task name, command, schedule, and last execution status.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Settings/Invoke-ListCIPPUsers.ps1

@@ -4,6 +4,8 @@ function Invoke-ListCIPPUsers {
         Entrypoint,AnyTenant
     .ROLE
         CIPP.SuperAdmin.Read
+    .DESCRIPTION
+        Lists CIPP platform users and their role assignments from the allowedUsers table. Requires SuperAdmin access.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Settings/Invoke-ListContainerLogs.ps1

@@ -4,6 +4,8 @@ function Invoke-ListContainerLogs {
         Entrypoint,AnyTenant
     .ROLE
         CIPP.SuperAdmin.Read
+    .DESCRIPTION
+        Retrieves container logs for the CIPP backend process. Requires SuperAdmin access. Supports ReadLog, ListFiles, and snapshot actions.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Settings/Invoke-ListCustomRole.ps1

@@ -4,6 +4,8 @@ function Invoke-ListCustomRole {
         Entrypoint
     .ROLE
         CIPP.Core.Read
+    .DESCRIPTION
+        Lists custom RBAC roles defined in CIPP, including their permission sets and associated access role groups.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Settings/Invoke-ListCustomVariables.ps1

@@ -4,6 +4,8 @@ function Invoke-ListCustomVariables {
         Entrypoint
     .ROLE
         CIPP.Core.Read
+    .DESCRIPTION
+        Lists custom variables configured in CIPP for use in templates and automation.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Settings/Invoke-ListExcludedLicenses.ps1

@@ -4,6 +4,8 @@ function Invoke-ListExcludedLicenses {
         Entrypoint
     .ROLE
         CIPP.AppSettings.Read
+    .DESCRIPTION
+        Lists license SKUs that have been excluded from CIPP license counts and reporting.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Settings/Invoke-ListTenantGroups.ps1

@@ -6,6 +6,8 @@ function Invoke-ListTenantGroups {
         Entrypoint,AnyTenant
     .ROLE
         CIPP.Core.Read
+    .DESCRIPTION
+        Lists tenant groups (logical groupings of managed tenants) and optionally includes usage data.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/CIPP/Settings/Invoke-ListWorkerHealth.ps1

@@ -4,6 +4,8 @@ function Invoke-ListWorkerHealth {
         Entrypoint,AnyTenant
     .ROLE
         CIPP.SuperAdmin.Read
+    .DESCRIPTION
+        Retrieves health status and diagnostics for CIPP background worker processes. Requires SuperAdmin access.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Administration/Contacts/Invoke-ListContactTemplates.ps1

@@ -4,6 +4,8 @@ function Invoke-ListContactTemplates {
         Entrypoint,AnyTenant
     .ROLE
         Exchange.Contact.Read
+    .DESCRIPTION
+        Lists saved mail contact templates used for creating new Exchange contacts.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Administration/Contacts/Invoke-ListContacts.ps1

@@ -7,6 +7,8 @@ function Invoke-ListContacts {
         Entrypoint
     .ROLE
         Exchange.Contact.Read
+    .DESCRIPTION
+        Lists Exchange Online mail contacts for a tenant, with optional filtering by contact ID for detailed view.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Administration/Invoke-ListContactPermissions.ps1

@@ -4,6 +4,8 @@ Function Invoke-ListContactPermissions {
         Entrypoint
     .ROLE
         Exchange.Mailbox.Read
+    .DESCRIPTION
+        Lists folder-level permissions on a user's Contacts folder in Exchange Online.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Administration/Invoke-ListMailboxMobileDevices.ps1

@@ -4,6 +4,8 @@ Function Invoke-ListMailboxMobileDevices {
         Entrypoint
     .ROLE
         Exchange.Mailbox.Read
+    .DESCRIPTION
+        Lists mobile devices associated with a specific Exchange Online mailbox.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Administration/Invoke-ListOoO.ps1

@@ -4,6 +4,8 @@ Function Invoke-ListOoO {
         Entrypoint
     .ROLE
         Exchange.Mailbox.Read
+    .DESCRIPTION
+        Retrieves Out of Office (automatic reply) settings for a specific Exchange Online user.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Administration/Invoke-ListSharedMailboxStatistics.ps1

@@ -4,6 +4,8 @@ Function Invoke-ListSharedMailboxStatistics {
         Entrypoint
     .ROLE
         Exchange.Mailbox.Read
+    .DESCRIPTION
+        Lists shared mailboxes and their usage statistics for a tenant.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Reports/Invoke-ListActiveSyncDevices.ps1

@@ -4,6 +4,8 @@ function Invoke-ListActiveSyncDevices {
         Entrypoint
     .ROLE
         Exchange.Mailbox.Read
+    .DESCRIPTION
+        Lists all ActiveSync mobile devices registered across Exchange Online mailboxes in a tenant.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Reports/Invoke-ListAntiPhishingFilters.ps1

@@ -4,6 +4,8 @@ function Invoke-ListAntiPhishingFilters {
         Entrypoint
     .ROLE
         Exchange.SpamFilter.Read
+    .DESCRIPTION
+        Lists anti-phishing policies and their associated rules configured in Exchange Online Protection.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Reports/Invoke-ListGlobalAddressList.ps1

@@ -4,6 +4,8 @@ Function Invoke-ListGlobalAddressList {
         Entrypoint
     .ROLE
         Exchange.Mailbox.Read
+    .DESCRIPTION
+        Lists all recipients in the Exchange Online Global Address List, including display names, email addresses, and recipient types.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Reports/Invoke-ListMailboxCAS.ps1

@@ -4,6 +4,8 @@ function Invoke-ListMailboxCAS {
         Entrypoint
     .ROLE
         Exchange.Mailbox.Read
+    .DESCRIPTION
+        Lists Client Access Settings (CAS) for Exchange Online mailboxes, showing which protocols are enabled (OWA, IMAP, POP, MAPI, EWS, ActiveSync).
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Reports/Invoke-ListMalwareFilters.ps1

@@ -4,6 +4,8 @@ function Invoke-ListMalwareFilters {
         Entrypoint
     .ROLE
         Exchange.SpamFilter.Read
+    .DESCRIPTION
+        Lists malware filter policies and their associated rules configured in Exchange Online Protection.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Reports/Invoke-ListSafeAttachmentsFilters.ps1

@@ -4,6 +4,8 @@ function Invoke-ListSafeAttachmentsFilters {
         Entrypoint
     .ROLE
         Exchange.SpamFilter.Read
+    .DESCRIPTION
+        Lists Safe Attachments policies and their associated rules configured in Microsoft Defender for Office 365.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Reports/Invoke-ListSharedMailboxAccountEnabled.ps1

@@ -4,6 +4,8 @@ function Invoke-ListSharedMailboxAccountEnabled {
         Entrypoint
     .ROLE
         Exchange.Mailbox.Read
+    .DESCRIPTION
+        Lists shared mailboxes that have direct sign-in enabled (account not disabled), which is a security concern.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Resources/Invoke-ListEquipment.ps1

@@ -4,6 +4,8 @@ function Invoke-ListEquipment {
         Entrypoint
     .ROLE
         Exchange.Equipment.Read
+    .DESCRIPTION
+        Lists equipment mailboxes (projectors, vehicles, etc.) in Exchange Online for a tenant.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Resources/Invoke-ListRoomLists.ps1

@@ -4,6 +4,8 @@ Function Invoke-ListRoomLists {
         Entrypoint
     .ROLE
         Exchange.Room.Read
+    .DESCRIPTION
+        Lists room list distribution groups and their members in Exchange Online.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Resources/Invoke-ListRooms.ps1

@@ -4,6 +4,8 @@ function Invoke-ListRooms {
         Entrypoint
     .ROLE
         Exchange.Room.Read
+    .DESCRIPTION
+        Lists room mailboxes (meeting rooms) in Exchange Online for a tenant, with optional detailed view by room ID.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Spamfilter/Invoke-ListConnectionFilter.ps1

@@ -4,6 +4,8 @@ function Invoke-ListConnectionFilter {
         Entrypoint
     .ROLE
         Exchange.ConnectionFilter.Read
+    .DESCRIPTION
+        Lists hosted connection filter policies (IP allow/block lists) in Exchange Online Protection.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Spamfilter/Invoke-ListConnectionFilterTemplates.ps1

@@ -4,6 +4,8 @@ Function Invoke-ListConnectionFilterTemplates {
         Entrypoint,AnyTenant
     .ROLE
         Exchange.ConnectionFilter.Read
+    .DESCRIPTION
+        Lists saved connection filter policy templates for Exchange Online Protection.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Spamfilter/Invoke-ListMailQuarantine.ps1

@@ -4,6 +4,8 @@ function Invoke-ListMailQuarantine {
         Entrypoint
     .ROLE
         Exchange.SpamFilter.Read
+    .DESCRIPTION
+        Lists quarantined email messages in Exchange Online Protection for a tenant.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Spamfilter/Invoke-ListMailQuarantineMessage.ps1

@@ -4,6 +4,8 @@ function Invoke-ListMailQuarantineMessage {
         Entrypoint
     .ROLE
         Exchange.SpamFilter.Read
+    .DESCRIPTION
+        Exports and retrieves the raw EML content of a specific quarantined email message by its Identity.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Spamfilter/Invoke-ListQuarantinePolicy.ps1

@@ -4,6 +4,8 @@ function Invoke-ListQuarantinePolicy {
         Entrypoint
     .ROLE
         Exchange.SpamFilter.Read
+    .DESCRIPTION
+        Lists quarantine policies configured in Exchange Online Protection, controlling end-user access to quarantined messages.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Spamfilter/Invoke-ListSpamFilterTemplates.ps1

@@ -4,6 +4,8 @@ Function Invoke-ListSpamFilterTemplates {
         Entrypoint,AnyTenant
     .ROLE
         Exchange.SpamFilter.Read
+    .DESCRIPTION
+        Lists saved spam filter policy templates for Exchange Online Protection.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Spamfilter/Invoke-ListSpamfilter.ps1

@@ -4,6 +4,8 @@ Function Invoke-ListSpamfilter {
         Entrypoint
     .ROLE
         Exchange.SpamFilter.Read
+    .DESCRIPTION
+        Lists hosted content filter (anti-spam) policies and their rule states in Exchange Online Protection.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)

Modules/CIPPHTTP/Public/Entrypoints/HTTP Functions/Email-Exchange/Spamfilter/Invoke-ListTenantAllowBlockListTemplates.ps1

@@ -4,6 +4,8 @@ Function Invoke-ListTenantAllowBlockListTemplates {
         Entrypoint,AnyTenant
     .ROLE
         Exchange.SpamFilter.Read
+    .DESCRIPTION
+        Lists saved Tenant Allow/Block List templates for Exchange Online Protection.
     #>
     [CmdletBinding()]
     param($Request, $TriggerMetadata)