Elenca le policy di conservazione (retention) configurate nel centro conformita.
Lo script si collega al centro sicurezza e conformita di Microsoft 365 e recupera tutte le policy di conservazione configurate, riportando ambito di applicazione e regole associate a ciascuna.
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-PolicyConservazione.ps1
La stessa esecuzione con tutti i parametri scritti per esteso (qui con i valori predefiniti, da adattare al tuo ambiente):
.\Report-PolicyConservazione.ps1 -PercorsoCSV "C:\Report\PolicyConservazione.csv"
Parametri
| Parametro | Tipo | Obbligatorio | Valore predefinito | A cosa serve |
|---|---|---|---|---|
-PercorsoCSV | testo | no | C:\Report\PolicyConservazione.csv | file CSV in cui viene salvato il risultato |
Cosa restituisce
- Un file CSV in
C:\Report\PolicyConservazione.csv(si cambia con-PercorsoCSV) con il punto e virgola come separatore, così Excel in italiano lo apre già diviso in colonne. Colonne:Policy,Abilitata,Ambito,NumeroRegole. - A video, un riepilogo a colori: verde quando l’esito è positivo.
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-PolicyConservazione.ps1.
I comandi usati dallo script
Connect-IPPSSession: apre la sessione con Security & Compliance (Microsoft Purview).Get-RetentionCompliancePolicy: elenca i criteri di conservazione di Microsoft Purview.Get-RetentionComplianceRule: mostra le regole (durata e azione) dei criteri di conservazione.Export-Csv: salva gli oggetti in un file CSV, una colonna per ogni proprietà.
Il codice completo
È lo stesso contenuto del file scaricabile (25 righe): leggilo prima di eseguirlo, come si dovrebbe fare con qualsiasi script preso da Internet.
<#
.SYNOPSIS
Elenca le policy di conservazione (retention) configurate nel centro conformità.
#>
param(
[string]$PercorsoCSV = "C:\Report\PolicyConservazione.csv"
)
Import-Module ExchangeOnlineManagement
Connect-IPPSSession
$policy = Get-RetentionCompliancePolicy
$risultati = foreach ($p in $policy) {
$regole = Get-RetentionComplianceRule -Policy $p.Name -ErrorAction SilentlyContinue
[PSCustomObject]@{
Policy = $p.Name
Abilitata = $p.Enabled
Ambito = ($p.ExchangeLocation -join ", ")
NumeroRegole = $regole.Count
}
}
$risultati | Export-Csv -Path $PercorsoCSV -NoTypeInformation -Encoding UTF8 -Delimiter ";"
Write-Host "Esportate $($risultati.Count) policy di conservazione." -ForegroundColor Green
Approfondimenti
- Come configurare una policy di conservazione email
- Per farlo girare ogni giorno in automatico: Come pianificare uno script con Task Scheduler
- Tutte le guide Microsoft 365
- Gli altri script Microsoft 365