Utenti con ruoli amministrativi Microsoft 365

Elenca tutti gli utenti assegnati a ruoli con privilegi amministrativi nel tenant.

Lo script recupera tutti i ruoli di directory disponibili nel tenant e, per ciascuno, ne elenca i membri attualmente assegnati, producendo una mappa completa di chi ha privilegi amministrativi e su cosa.

Prerequisiti Modulo Microsoft.Graph, permessi RoleManagement.Read.Directory

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

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

.\Report-RuoliAmministrativi.ps1 -PercorsoCSV "C:\Report\RuoliAmministrativi.csv"

Parametri

ParametroTipoObbligatorioValore predefinitoA cosa serve
-PercorsoCSVtestonoC:\Report\RuoliAmministrativi.csvfile CSV in cui viene salvato il risultato

Cosa restituisce

  • Un file CSV in C:\Report\RuoliAmministrativi.csv (si cambia con -PercorsoCSV) con il punto e virgola come separatore, così Excel in italiano lo apre già diviso in colonne. Colonne: Ruolo, Utente.
  • A video, un riepilogo a colori: verde quando l’esito è positivo.

Requisiti

  • Microsoft Graph PowerShell SDK: Install-Module Microsoft.Graph -Scope CurrentUser (oppure solo i sottomoduli usati dallo script).
  • Permessi Microsoft Graph richiesti all’accesso: RoleManagement.Read.Directory. 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-RuoliAmministrativi.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 tutti gli utenti assegnati a ruoli con privilegi amministrativi nel tenant.
#>
param(
    [string]$PercorsoCSV = "C:\Report\RuoliAmministrativi.csv"
)

Import-Module Microsoft.Graph.Identity.DirectoryManagement
Connect-MgGraph -Scopes "RoleManagement.Read.Directory" -NoWelcome

$ruoli = Get-MgDirectoryRole

$risultati = foreach ($r in $ruoli) {
    $membri = Get-MgDirectoryRoleMember -DirectoryRoleId $r.Id
    foreach ($m in $membri) {
        [PSCustomObject]@{
            Ruolo  = $r.DisplayName
            Utente = $m.AdditionalProperties["displayName"]
        }
    }
}

$risultati | Sort-Object Ruolo | Export-Csv -Path $PercorsoCSV -NoTypeInformation -Encoding UTF8 -Delimiter ";"
Write-Host "Esportati $($risultati.Count) assegnamenti di ruoli amministrativi." -ForegroundColor Green

Approfondimenti

Privacy Policy Cookie Policy