Attività amministrative recenti

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.

Prerequisiti Modulo ExchangeOnlineManagement, ruolo di audit

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

ParametroTipoObbligatorioValore predefinitoA cosa serve
-OreIndietronumero interono24—
-PercorsoCSVtestonoC:\Report\AuditAmministrativo.csvfile 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

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

Privacy Policy Cookie Policy