IntuneBackup

1.0.1

backup/Backup-EnrollmentStatusPage.ps1

#Requires -Version 7.0
function Backup-EnrollmentStatusPage {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory)] [string]$BackupPath,
        [Parameter(Mandatory)] [SecureString]$Token,
        [hashtable]$ScopeTagMap = @{}
    )

    try {
        $folder = Join-Path $BackupPath 'Enrollment Profiles' 'Windows' 'ESP'
        $uri = '/beta/deviceManagement/deviceEnrollmentConfigurations'
        $items = Invoke-GraphRequest2 -Uri $uri -Token $Token

        foreach ($item in $items) {
            # only include Windows 10 ESP configurations
            if ($item.'@odata.type' -ne '#microsoft.graph.windows10EnrollmentCompletionPageConfiguration') {
                continue
            }

            # resolve selected mobile app IDs to names
            if ($item.selectedMobileAppIds) {
                $appNames = @()
                foreach ($appId in $item.selectedMobileAppIds) {
                    $appUri = "/beta/deviceAppManagement/mobileApps/$appId"
                    $app = Invoke-GraphRequest2 -Uri $appUri -Token $Token
                    if ($app) {
                        $appType = $app.'@odata.type' -replace '.*\.graph\.', ''
                        $appNames += @{
                            appName = $app.displayName
                            type = $appType
                        }
                    }
                }
                if ($appNames) {
                    $item | Add-Member -MemberType NoteProperty -Name 'selectedMobileAppNames' -Value $appNames -Force
                }
            }

            $assignments = Resolve-Assignments -AssignmentsUri "/beta/deviceManagement/deviceEnrollmentConfigurations/$($item.id)/assignments" -Token $Token
            if ($assignments) {
                $item | Add-Member -MemberType NoteProperty -Name 'assignments' -Value $assignments -Force
            }

            # construct filename
            $odataType = $item.'@odata.type'
            $type = $odataType -replace '#microsoft\.graph\.', ''
            $fileName = "$($item.displayName)_$type"

            $clean = Remove-VolatileKeys -InputObject $item
            Save-BackupItem -Item $clean -Folder $folder -FileName $fileName -ScopeTagMap $ScopeTagMap
        }
        Write-Verbose "backed up enrollment status pages to $folder"
    }
    catch {
        Write-Error "failed to backup enrollment status pages: $_"
        return
    }
}

Export-ModuleMember -Function Backup-EnrollmentStatusPage