Entra / Microsoft 365 · Compliance & audit
Report audit recs guest doc access
Search the unified audit log for guest document access events in SharePoint Online and OneDrive.
Connect & set up
Run these once per session. All scopes are read-only unless the script makes changes.
Connect-ExchangeOnline -SkipLoadingCmdletHelp
Run it
The main script. Copy it, or download the .ps1 and run it from your console.
param([int] $LookbackDays = 90)[array]$Modules = Get-Module | Select-Object -ExpandProperty NameIf ("ExchangeOnlineManagement" -notin $Modules) {Write-Host "Loading Exchange Online Management module"Connect-ExchangeOnline -SkipLoadingCmdletHelp}Write-Host "Searching for SharePoint file access audit records..."[array]$Records = Search-UnifiedAuditLog -StartDate (Get-Date).AddDays(-$LookbackDays) -EndDate (Get-Date).AddDays(+1) `-Operations FileAccessed -ResultSize 5000 -Formatted -SessionCommand ReturnLargeSetIf ($Records.Count -eq 0) {Write-Host "No SharePoint file access records found for guest users."Break}# Remove any duplicates and sort by date and extract the records for guest users$Records = $Records | Sort-Object Identity -Unique | Where-Object {$_.UserIds -Like "*#EXT#*" } | Sort-Object { $_.CreationDate -as [datetime]} -DescendingWrite-Host "Processing" $Records.Count" SharePoint file access audit records..."$Report = [System.Collections.Generic.List[Object]]::new()ForEach ($Rec in $Records) {$AuditData = ConvertFrom-Json $Rec.AuditdataIf ($AuditData.SourceFileName -NotLike "*aspx*" -And $AuditData.SourceFileName -NotLike "*jpg*" ) {$ReportLine = [PSCustomObject]@{TimeStamp = $Rec.CreationDateUser = $Rec.UserIdsAction = $AuditData.OperationWorkload = $AuditData.WorkloadURL = $AuditData.SiteUrlDocument = $AuditData.SourceFileName}$Report.Add($ReportLine)}}$Report | Out-GridView
Parameters
ParameterDefaultNotes
-LookbackDays90Number of days back to search the unified audit log.Attribution
Author
Office365itpros