Policy di conservazione email attive

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.

Prerequisiti Modulo ExchangeOnlineManagement, permessi Compliance

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

ParametroTipoObbligatorioValore predefinitoA cosa serve
-PercorsoCSVtestonoC:\Report\PolicyConservazione.csvfile 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

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

Privacy Policy Cookie Policy