Estrae dal registro di controllo unificato le operazioni amministrative piu recenti.
Lo script interroga il registro di controllo unificato di Microsoft 365 (Unified Audit Log) filtrando sulle operazioni amministrative piu comuni (creazione utenti, modifica ruoli, modifiche a policy) nelle ultime N ore.
Come si usa
Scarica il file, apri PowerShell nella cartella in cui l’hai salvato ed eseguilo: tutti i parametri hanno un valore predefinito, quindi basta il nome dello script.
.\Report-AuditAmministrativo.ps1
La stessa esecuzione con tutti i parametri scritti per esteso (qui con i valori predefiniti, da adattare al tuo ambiente):
.\Report-AuditAmministrativo.ps1 -OreIndietro 24 -PercorsoCSV "C:\Report\AuditAmministrativo.csv"
Parametri
| Parametro | Tipo | Obbligatorio | Valore predefinito | A cosa serve |
|---|---|---|---|---|
-OreIndietro | numero intero | no | 24 | — |
-PercorsoCSV | testo | no | C:\Report\AuditAmministrativo.csv | file CSV in cui viene salvato il risultato |
Cosa restituisce
- Un file CSV in
C:\Report\AuditAmministrativo.csv(si cambia con-PercorsoCSV) con il punto e virgola come separatore, così Excel in italiano lo apre già diviso in colonne. Colonne:CreationDate,UserIds,Operations,ResultIndex. - A video, un riepilogo a colori: azzurro per titoli e informazioni.
Requisiti
- Modulo ExchangeOnlineManagement:
Install-Module ExchangeOnlineManagement -Scope CurrentUser. - La cartella di destinazione (
C:\Report) deve già esistere: lo script non la crea. - Se Windows blocca l’esecuzione perché il file arriva da Internet, sbloccalo una volta con
Unblock-File .\Report-AuditAmministrativo.ps1.
I comandi usati dallo script
Connect-ExchangeOnline: apre la sessione con Exchange Online (modulo ExchangeOnlineManagement).Search-UnifiedAuditLog: cerca nel registro di controllo unificato di Microsoft 365.Export-Csv: salva gli oggetti in un file CSV, una colonna per ogni proprietà.Disconnect-ExchangeOnline: chiude la sessione con Exchange Online.
Il codice completo
È lo stesso contenuto del file scaricabile (24 righe): leggilo prima di eseguirlo, come si dovrebbe fare con qualsiasi script preso da Internet.
<#
.SYNOPSIS
Estrae dal registro di controllo unificato le operazioni amministrative più recenti.
#>
param(
[int]$OreIndietro = 24,
[string]$PercorsoCSV = "C:\Report\AuditAmministrativo.csv"
)
Import-Module ExchangeOnlineManagement
Connect-ExchangeOnline -ShowBanner:$false
$dataInizio = (Get-Date).AddHours(-$OreIndietro)
$dataFine = Get-Date
$operazioni = @("Add-MailboxPermission","Add member to group","Add member to role",
"Set-Mailbox","Update user","Add user")
$risultati = Search-UnifiedAuditLog -StartDate $dataInizio -EndDate $dataFine -Operations $operazioni -ResultSize 500 |
Select-Object CreationDate, UserIds, Operations, ResultIndex
$risultati | Export-Csv -Path $PercorsoCSV -NoTypeInformation -Encoding UTF8 -Delimiter ";"
Write-Host "Trovate $($risultati.Count) operazioni amministrative nelle ultime $OreIndietro ore." -ForegroundColor Cyan
Disconnect-ExchangeOnline -Confirm:$false
Approfondimenti
- Per farlo girare ogni giorno in automatico: Come pianificare uno script con Task Scheduler
- Tutte le guide Microsoft 365
- Gli altri script Microsoft 365