Add time settings management for function app

Extended Invoke-ExecBackendURLs.ps1 to include Hosted, OS, SKU, Timezone, and business hours properties. Added Invoke-ExecTimeSettings.ps1 to handle updating timezone and business hours settings for the function app, including validation and Azure app settings update logic.

Author: JohnDuprey

Modules/CIPPCore/Public/Entrypoints/HTTP Functions/CIPP/Settings/Invoke-ExecBackendURLs.ps1

@@ -32,6 +32,12 @@ function Invoke-ExecBackendURLs {
         RGName             = $RGName
         FunctionName       = $env:WEBSITE_SITE_NAME
         SWAName            = $SWAName
+        Hosted             = $env:CIPP_HOSTED -eq 'true' ?? $false
+        OS                 = $IsLinux ? 'Linux' : 'Windows'
+        SKU                = $env:WEBSITE_SKU
+        Timezone           = $env:WEBSITE_TIME_ZONE ?? 'UTC'
+        BusinessHoursStart = $env:CIPP_BUSINESS_HOURS_START ?? '09:00'
+        BusinessHoursEnd   = $env:CIPP_BUSINESS_HOURS_END ?? '17:00'
     }
 
 

Modules/CIPPCore/Public/Entrypoints/HTTP Functions/CIPP/Settings/Invoke-ExecTimeSettings.ps1

@@ -0,0 +1,108 @@
+function Invoke-ExecTimeSettings {
+    <#
+    .FUNCTIONALITY
+        Entrypoint
+    .ROLE
+        CIPP.SuperAdmin.ReadWrite
+    #>
+    [CmdletBinding()]
+    param($Request, $TriggerMetadata)
+
+    try {
+        $Subscription = $env:WEBSITE_OWNER_NAME -split '\+' | Select-Object -First 1
+        $Owner = $env:WEBSITE_OWNER_NAME
+
+        if ($env:WEBSITE_SKU -ne 'FlexConsumption' -and $Owner -match '^(?<SubscriptionId>[^+]+)\+(?<RGName>[^-]+(?:-[^-]+)*?)(?:-[^-]+webspace(?:-Linux)?)?$') {
+            $RGName = $Matches.RGName
+        } else {
+            $RGName = $env:WEBSITE_RESOURCE_GROUP
+        }
+
+        $FunctionName = $env:WEBSITE_SITE_NAME
+        $Timezone = $Request.Body.Timezone.value ?? $Request.Body.Timezone
+        $BusinessHoursStart = $Request.Body.BusinessHoursStart.value ?? $Request.Body.BusinessHoursStart
+
+        # Validate timezone format
+        if (-not $Timezone) {
+            throw 'Timezone is required'
+        }
+
+        if (!$IsLinux) {
+            # Get Timezone standard name for Windows
+            $Timezone = Get-TimeZone -Id $Timezone | Select-Object -ExpandProperty StandardName
+        }
+
+        # Calculate business hours end time (10 hours after start)
+        $BusinessHoursEnd = $null
+        if ($env:WEBSITE_SKU -eq 'FlexConsumption') {
+            if (-not $BusinessHoursStart) {
+                throw 'Business hours start time is required for Flex Consumption plans'
+            }
+
+            # Validate time format (HH:mm)
+            if ($BusinessHoursStart -notmatch '^\d{2}:\d{2}$') {
+                throw 'Business hours start time must be in HH:mm format'
+            }
+
+            # Calculate end time (start + 10 hours)
+            $StartTime = [DateTime]::ParseExact($BusinessHoursStart, 'HH:mm', $null)
+            $EndTime = $StartTime.AddHours(10)
+            $BusinessHoursEnd = $EndTime.ToString('HH:mm')
+        }
+
+        Write-Information "Updating function app time settings: Timezone=$Timezone, BusinessHoursStart=$BusinessHoursStart, BusinessHoursEnd=$BusinessHoursEnd"
+
+        # Get current app settings
+        $Token = Get-AzAccessToken -ResourceUrl 'https://management.azure.com'
+        $Headers = @{
+            Authorization  = "Bearer $($Token.Token)"
+            'Content-Type' = 'application/json'
+        }
+
+        $AppSettingsUrl = "https://management.azure.com/subscriptions/$Subscription/resourceGroups/$RGName/providers/Microsoft.Web/sites/$FunctionName/config/appsettings/list?api-version=2022-03-01"
+
+        $CurrentSettings = Invoke-RestMethod -Uri $AppSettingsUrl -Method POST -Headers $Headers
+
+        # Update settings
+        $CurrentSettings.properties['WEBSITE_TIME_ZONE'] = $Timezone
+
+        if ($env:WEBSITE_SKU -eq 'FlexConsumption') {
+            $CurrentSettings.properties['CIPP_BUSINESS_HOURS_START'] = $BusinessHoursStart
+            $CurrentSettings.properties['CIPP_BUSINESS_HOURS_END'] = $BusinessHoursEnd
+        }
+
+        # Save settings
+        $UpdateUrl = "https://management.azure.com/subscriptions/$Subscription/resourceGroups/$RGName/providers/Microsoft.Web/sites/$FunctionName/config/appsettings?api-version=2022-03-01"
+
+        $UpdateResponse = Invoke-RestMethod -Uri $UpdateUrl -Method PUT -Headers $Headers -Body ($CurrentSettings | ConvertTo-Json -Depth 10)
+
+        Write-LogMessage -API 'ExecTimeSettings' -headers $Request.Headers -message "Updated time settings: Timezone=$Timezone, BusinessHours=$BusinessHoursStart-$BusinessHoursEnd" -Sev 'Info'
+
+        $Results = @{
+            Results  = 'Time settings updated successfully. Please note that timezone changes may require a function app restart to take effect.'
+            Timezone = $Timezone
+            SKU      = $env:WEBSITE_SKU
+        }
+
+        if ($env:WEBSITE_SKU -eq 'FlexConsumption') {
+            $Results.BusinessHoursStart = $BusinessHoursStart
+            $Results.BusinessHoursEnd = $BusinessHoursEnd
+        }
+
+        return ([HttpResponseContext]@{
+                StatusCode = [httpstatusCode]::OK
+                Body       = $Results
+            })
+
+    } catch {
+        $ErrorMessage = Get-CippException -Exception $_
+        Write-LogMessage -API 'ExecTimeSettings' -headers $Request.Headers -message "Failed to update time settings: $($ErrorMessage.NormalizedError)" -Sev 'Error' -LogData $ErrorMessage
+
+        return ([HttpResponseContext]@{
+                StatusCode = [httpstatusCode]::BadRequest
+                Body       = @{
+                    Results = "Failed to update time settings: $($ErrorMessage.NormalizedError)"
+                }
+            })
+    }
+}