Utenti guest inattivi

Individua gli account guest che non accedono al tenant da tempo.

Lo script recupera tutti gli utenti di tipo Guest e ne verifica la data di ultimo accesso registrato, segnalando quelli inattivi da piu della soglia di giorni configurata.

Prerequisiti Modulo Microsoft.Graph, permessi User.Read.All, AuditLog.Read.All

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-GuestInattivi.ps1

La stessa esecuzione con tutti i parametri scritti per esteso (qui con i valori predefiniti, da adattare al tuo ambiente):

.\Report-GuestInattivi.ps1 -GiorniSoglia 90 -PercorsoCSV "C:\Report\GuestInattivi.csv"

Parametri

ParametroTipoObbligatorioValore predefinitoA cosa serve
-GiorniSoglianumero interono90—
-PercorsoCSVtestonoC:\Report\GuestInattivi.csvfile CSV in cui viene salvato il risultato

Cosa restituisce

  • Un file CSV in C:\Report\GuestInattivi.csv (si cambia con -PercorsoCSV) con il punto e virgola come separatore, così Excel in italiano lo apre già diviso in colonne. Colonne: DisplayName, Mail, UltimoAccesso, Creato.
  • A video, un riepilogo a colori: giallo per avvisi e valori da controllare.

Requisiti

  • Microsoft Graph PowerShell SDK: Install-Module Microsoft.Graph -Scope CurrentUser (oppure solo i sottomoduli usati dallo script).
  • Permessi Microsoft Graph richiesti all’accesso: User.Read.All, AuditLog.Read.All. La prima volta Microsoft Entra ID chiede il consenso, che per questi permessi di solito deve concedere un amministratore.
  • 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-GuestInattivi.ps1.

I comandi usati dallo script

  • Connect-MgGraph: apre la sessione con Microsoft Graph chiedendo i permessi (scope) indicati.
  • Get-MgUser: legge gli utenti di Microsoft Entra ID; con -Property si scelgono gli attributi da restituire.
  • Export-Csv: salva gli oggetti in un file CSV, una colonna per ogni proprietà.

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
    Individua gli account guest che non accedono al tenant da tempo.
#>
param(
    [int]$GiorniSoglia = 90,
    [string]$PercorsoCSV = "C:\Report\GuestInattivi.csv"
)

Import-Module Microsoft.Graph.Users
Connect-MgGraph -Scopes "User.Read.All", "AuditLog.Read.All" -NoWelcome

$guest = Get-MgUser -Filter "userType eq 'Guest'" -All -Property DisplayName, Mail, SignInActivity, CreatedDateTime

$dataLimite = (Get-Date).AddDays(-$GiorniSoglia)

$risultati = $guest | Where-Object {
    -not $_.SignInActivity.LastSignInDateTime -or $_.SignInActivity.LastSignInDateTime -lt $dataLimite
} | Select-Object DisplayName, Mail,
    @{N="UltimoAccesso";E={if($_.SignInActivity.LastSignInDateTime){$_.SignInActivity.LastSignInDateTime}else{"Mai"}}},
    @{N="Creato";E={$_.CreatedDateTime}}

$risultati | Export-Csv -Path $PercorsoCSV -NoTypeInformation -Encoding UTF8 -Delimiter ";"
Write-Host "Trovati $($risultati.Count) guest inattivi da oltre $GiorniSoglia giorni." -ForegroundColor Yellow

Approfondimenti

Privacy Policy Cookie Policy