Deleted a *very* large directory in SharePoint Online? Restore the files en masse with the SPO PnP Module

Restore-SPO-Files.ps1

# Needs the SharePoint Online PnP module, install if haven't got it already:
# Install-Module SharePointPnPPowerShellOnline

$Uri = 'https://tenant.sharepoint.com/sites/Common'

Connect-PnPOnline -Url $Uri -UseWebLogin

$DeletedAt = (Get-Date -Day 24 -Month 05 -Hour 0 -Minute 0 -Second 0)
$DeletedBy = '[email protected]'

$DeletedItems = Get-PnPRecycleBinItem
$DeletedItems.Where({$_.DeletedByEmail -eq $DeletedBy -and $_.DeletedDate -gt $DeletedAt}) |
    Restore-PnpRecycleBinItem -Force