"syncInfoNote": "Outlook for iOS and Android uses modern authentication and does not report ActiveSync sync times."

UI now has a clear explanation available for empty sync fields
API responses are easier to reason about (null vs empty string)
Reduces confusion around Outlook mobile ActiveSync reporting
No functional changes to device allow/block/delete operations

Signed-off-by: fit-jv <Jaco.Venter@FocusedIT.co.uk>

Author: fit-jv

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

@@ -12,21 +12,23 @@ function Invoke-ListActiveSyncDevices {
 
     try {
         $GraphRequest = New-ExoRequest -tenantid $TenantFilter -cmdlet 'Get-MobileDevice' -cmdParams @{ ResultSize = 'Unlimited' } |
-        Select-Object @{ Name = 'userDisplayName'; Expression = { $_.UserDisplayName } },
-        @{ Name = 'userPrincipalName'; Expression = { ($_.Identity -split '\\')[0] } },
-        @{ Name = 'deviceFriendlyName'; Expression = { if ([string]::IsNullOrEmpty($_.FriendlyName)) { 'Unknown' } else { $_.FriendlyName } } },
-        @{ Name = 'deviceModel'; Expression = { $_.DeviceModel } },
-        @{ Name = 'deviceOS'; Expression = { $_.DeviceOS } },
-        @{ Name = 'deviceType'; Expression = { $_.DeviceType } },
-        @{ Name = 'clientType'; Expression = { $_.ClientType } },
-        @{ Name = 'clientVersion'; Expression = { $_.ClientVersion } },
-        @{ Name = 'deviceAccessState'; Expression = { $_.DeviceAccessState } },
-        @{ Name = 'firstSyncTime'; Expression = { if ($_.FirstSyncTime) { $_.FirstSyncTime.ToString('yyyy-MM-ddTHH:mm:ssZ') } else { '' } } },
-        @{ Name = 'lastSyncAttemptTime'; Expression = { if ($_.LastSyncAttemptTime) { $_.LastSyncAttemptTime.ToString('yyyy-MM-ddTHH:mm:ssZ') } else { '' } } },
-        @{ Name = 'lastSuccessSync'; Expression = { if ($_.LastSuccessSync) { $_.LastSuccessSync.ToString('yyyy-MM-ddTHH:mm:ssZ') } else { '' } } },
-        @{ Name = 'deviceID'; Expression = { $_.DeviceId } },
-        @{ Name = 'identity'; Expression = { $_.Identity } },
-        @{ Name = 'Guid'; Expression = { $_.Guid } }
+		Select-Object @{ Name = 'userDisplayName'; Expression = { $_.UserDisplayName } },
+		@{ Name = 'userPrincipalName'; Expression = { ($_.Identity -split '\\')[0] } },
+		@{ Name = 'deviceFriendlyName'; Expression = { if ([string]::IsNullOrEmpty($_.FriendlyName)) { 'Unknown' } else { $_.FriendlyName } } },
+		@{ Name = 'deviceModel'; Expression = { $_.DeviceModel } },
+		@{ Name = 'deviceOS'; Expression = { $_.DeviceOS } },
+		@{ Name = 'deviceType'; Expression = { $_.DeviceType } },
+		@{ Name = 'clientType'; Expression = { $_.ClientType } },
+		@{ Name = 'clientVersion'; Expression = { $_.ClientVersion } },
+		@{ Name = 'deviceAccessState'; Expression = { $_.DeviceAccessState } },
+		@{ Name = 'firstSyncTime'; Expression = {if ($_.FirstSyncTime) {$_.FirstSyncTime.ToString('yyyy-MM-ddTHH:mm:ssZ')} else {$null}}},
+		@{ Name = 'lastSyncAttemptTime'; Expression = {if ($_.LastSyncAttemptTime) {$_.LastSyncAttemptTime.ToString('yyyy-MM-ddTHH:mm:ssZ')} else {$null}}},
+		@{ Name = 'lastSuccessSync'; Expression = {if ($_.LastSuccessSync) {$_.LastSuccessSync.ToString('yyyy-MM-ddTHH:mm:ssZ')} else {$null}}},
+		@{ Name = 'syncInfoNote'; Expression = {if ($_.DeviceModel -match 'Outlook' -or $_.DeviceType  -eq 'Outlook' -or $_.ClientType  -eq 'Outlook') {'Outlook for iOS and Android uses modern authentication and does not report ActiveSync sync times.'} else {$null}}},
+		@{ Name = 'deviceID'; Expression = { $_.DeviceId } },
+		@{ Name = 'identity'; Expression = { $_.Identity } },
+		@{ Name = 'Guid'; Expression = { $_.Guid } }
+		)
         $StatusCode = [HttpStatusCode]::OK
     } catch {
         $ErrorMessage = Get-NormalizedError -Message $_.Exception.Message