Microsoft Copilot Pages: Streamlined Access via Slash Commands & Library Tab—September 2026 Rollout

# Required Scopes: AuditLog.Read.All (Graph) / View-Only Audit Logs (EXO RBAC)
# Requires Exchange Online Management module for Search-UnifiedAuditLog
# Run BEFORE the Sep 2026 cutover to baseline Copilot Pages usage

#region Connect
Connect-ExchangeOnline

#region Baseline audit pull - last 30 days of Page activity
$startDate = (Get-Date).AddDays(-30)
$endDate   = Get-Date
$results   = @()
$sessionId = "CopilotPagesAudit-$(Get-Date -Format yyyyMMddHHmm)"

try {
    do {
        $batch = Search-UnifiedAuditLog `
            -StartDate $startDate `
            -EndDate $endDate `
            -RecordType CopilotInteraction `
            -Operations "PageCreated","PageEdited" `
            -SessionId $sessionId `
            -SessionCommand ReturnLargeSet `
            -ResultSize 5000

        if ($batch) { $results += $batch }
    } while ($batch.Count -eq 5000)

    $results |
        Select-Object CreationDate, UserIds, Operations, AuditData |
        Export-Csv -Path .\CopilotPagesActivity_Baseline.csv -NoTypeInformation

    Write-Output "Exported $($results.Count) Copilot Pages events to CSV."
    exit 0
}
catch {
    Write-Error "Audit pull failed: $($_.Exception.Message)"
    exit 1
}

# Required Scopes: User.Read.All, Organization.Read.All (Microsoft Graph)
# Enumerate users assigned a Copilot license SKU to scope comms distribution list

#region Connect via Microsoft.Graph v2 (NOT AzureAD/MSOnline - deprecated)
Connect-MgGraph -Scopes "User.Read.All","Organization.Read.All" -NoWelcome

try {
    # Common SKU part numbers: Microsoft_365_Copilot, Copilot_Chat
    $copilotSkuNames = @("Microsoft_365_Copilot", "Copilot_Chat")

    $licensedUsers = Get-MgUser -All -Property Id,DisplayName,UserPrincipalName,AssignedLicenses |
        Where-Object {
            $_.AssignedLicenses.SkuId | ForEach-Object {
                (Get-MgSubscribedSku -All | Where-Object SkuId -eq $_).SkuPartNumber -in $copilotSkuNames
            }
        }

    $licensedUsers |
        Select-Object DisplayName, UserPrincipalName |
        Export-Csv -Path .\CopilotLicensedUsers_ForComms.csv -NoTypeInformation

    Write-Output "Exported $($licensedUsers.Count) Copilot-licensed users."
    exit 0
}
catch {
    Write-Error "Graph enumeration failed: $($_.Exception.Message)"
    exit 1
}

# Change-management validation helper (no Graph/EXO dependency)
# Confirms MC1466760 acknowledgement + produces adoption report stub

function Test-MC1466760Readiness {
    [CmdletBinding(SupportsShouldProcess)]
    param(
        [Parameter(Mandatory)][string]$MessageCenterId = "MC1466760",
        [Parameter(Mandatory)][string]$OutputPath = ".\MC1466760_AdoptionReport.md"
    )

    try {
        $checklist = [ordered]@{
            "MessageCenterPostReviewed"      = $false
            "TrainingDocsAudited"            = $false
            "ChampionNoticeSent"             = $false
            "UsageBaselineCaptured"          = $false
            "ThirdPartyToolsValidated"       = $false
        }

        if ($PSCmdlet.ShouldProcess($OutputPath, "Generate adoption report")) {
            $report = @"
# Copilot Pages UX Change - Adoption Readiness Report
**Message Center ID:** $MessageCenterId
**Generated:** $(Get-Date -Format u)

| Checklist Item | Status |
|---|---|
$(($checklist.GetEnumerator() | ForEach-Object { "| $($_.Key) | $($_.Value) |" }) -join "`n")

**Next review date:** $((Get-Date).AddDays(7).ToString('yyyy-MM-dd'))
"@
            $report | Out-File -FilePath $OutputPath -Encoding utf8
            Write-Output "Report generated at $OutputPath"
        }
        exit 0
    }
    catch {
        Write-Error "Report generation failed: $($_.Exception.Message)"
        exit 1
    }
}

# Test-MC1466760Readiness -WhatIf