M365Con 2027 – conferenza online gratuita · 11–22 Jan 2027 · 120 sessions→ m365con.net
M365.FM DUB
ItalianoIT
EnglishEnglishDeutschDeutschEspañolEspañolFrançaisFrançaisItalianoItalianoPortuguêsPortuguêsNederlandsNederlandsPolskiPolskiBahasa IndonesiaBahasa IndonesiaРусскийРусскийУкраїнськаУкраїнськаالعربيةالعربيةעבריתעברית日本語日本語한국어한국어
☰
CommunityTutti gli episodiPodcastBlogVideosLibraryGuestsProfiloImpararePodcast

Blog · Mirko Peters

Come generare un report dei gruppi di ruolo di Microsoft Purview con PowerShell

By · · Updated

Usa PowerShell per creare un report sulle autorizzazioni dei gruppi di ruolo di Microsoft Purview. Controlla compliance, eDiscovery e Microsoft 365 con questa guida.

Automatically translated with AI from the original post. Read the English original

Gestire i gruppi di ruolo in Purview è fondamentale per mantenere la sicurezza e la conformità all'interno della tua organizzazione. Puoi semplificare questo processo sfruttando PowerShell, che automatizza le attività e fa risparmiare tempo. Con PowerShell puoi generare facilmente un report che descrive l'appartenenza ai gruppi di ruolo in Purview. Questa guida ti accompagna nei passaggi necessari per connetterti a Purview e creare il report in modo efficace.

Punti chiave

7 fatti sorprendenti sul report dei gruppi di ruolo di Microsoft Purview

Prerequisiti per PowerShell

Prerequisites for PowerShell

Autorizzazioni richieste

Prima di iniziare a usare PowerShell per generare report in Purview, verifica di avere le autorizzazioni necessarie. Ti servono accesso amministrativo a Purview. Questo accesso consente di visualizzare e gestire efficacemente i gruppi di ruolo. Senza queste autorizzazioni, potresti riscontrare errori durante l'esecuzione degli script o il recupero dei dati.

Installazione di PowerShell

Per eseguire gli script PowerShell, devi avere PowerShell installato sul tuo computer. La versione minima richiesta è la 5.1. Se non lo hai installato, puoi scaricarlo dal sito ufficiale Microsoft. Inoltre, ti servono moduli specifici per connetterti a Microsoft Purview: i moduli richiesti sono CAMP e AIPService.

Ecco una rapida checklist per verificare di soddisfare i prerequisiti:

Seguendo questi prerequisiti, ti preparerai a un'esperienza fluida durante la generazione del report sui gruppi di ruolo di Purview.

Riepilogo dei passaggi

  1. Verifica la versione di PowerShell.
  2. Installa i moduli necessari.
  3. Conferma i tuoi privilegi amministrativi in Purview.

Seguendo questi passaggi sarai pronto a usare PowerShell in modo efficace per le tue esigenze di reporting.

Connettiti a Microsoft Purview

Configura la connessione

Per connetterti a Microsoft Purview tramite PowerShell, segui questi passaggi:

  1. Assicurati di avere una sottoscrizione di Azure: ti serve una sottoscrizione di Azure valida e un tenant di Microsoft Entra collegato ad essa.
  2. Accedi al portale di Azure: usa le credenziali del tuo account Azure per accedere al portale.
  3. Installa Azure PowerShell o Azure CLI: assicurati di avere installati gli strumenti necessari sulla tua macchina client.
  4. Crea un gruppo di risorse: se non ne hai uno, esegui il seguente comando:
    New-AzResourceGroup -Name myResourceGroup -Location 'East US'
  5. Crea o distribuisci l'account di Microsoft Purview: usa questo comando per configurare il tuo account Purview:
    New-AzPurviewAccount

Seguendo questi passaggi potrai stabilire una connessione sicura a Microsoft Purview.

Autentica le credenziali

Una volta configurata la connessione, devi autenticare le tue credenziali. Ecco come fare:

  1. Apri PowerShell: avvia PowerShell sulla tua macchina.
  2. Esegui il comando di accesso: usa il seguente comando per accedere:
    Connect-AzAccount
    Questo comando ti chiede di inserire le credenziali del tuo account Azure.
  3. Verifica la connessione: dopo l'accesso, controlla di avere accesso al tuo account Purview eseguendo:
    Get-AzPurviewAccount

Se riscontri problemi durante il processo di connessione, considera questi errori comuni:

Seguendo questi passaggi potrai connetterti con successo a Microsoft Purview e autenticare le tue credenziali, preparando così la generazione del report sui gruppi di ruolo.

Genera il report sui gruppi di ruolo di Purview

Generate Purview Role Group Report

Script PowerShell per il report dei membri

Per generare un report sui gruppi di ruolo di Purview, puoi usare il seguente script PowerShell. Lo script si connette a Microsoft Graph e recupera i membri dei gruppi di ruolo. Segui questi passaggi per creare il report:

  1. Connettiti a Microsoft Graph: usa gli ambiti richiesti per accedere ai dati necessari.
  2. Connettiti a Exchange Online: assicurati di avere accesso all'endpoint di sicurezza e conformità.
  3. Recupera i gruppi di ruolo: esegui il cmdlet Get-RoleGroup per trovare tutti i gruppi di ruolo nel tuo tenant.
  4. Enumera i membri: per ogni gruppo di ruolo, individua i membri attuali. Distingui tra i diversi tipi di oggetti di Entra ID.
  5. Aggiorna gli elenchi PowerShell: crea degli elenchi per memorizzare i dettagli di ogni assegnazione di ruolo e di ogni appartenenza a un gruppo di ruolo.
  6. Identifica gli identificatori univoci: individua gli identificatori univoci che detengono assegnazioni di ruolo, come utenti o entità servizio.
  7. Raccogli i dettagli degli oggetti: per ogni identificatore univoco, raccogli informazioni aggiuntive come reparto e paese.
  8. Ordina le informazioni: organizza le informazioni sulle assegnazioni degli utenti per tipo di oggetto e nome, per facilitare il reporting.
  9. Genera il report HTML: crea un report HTML che includa i dettagli di ogni gruppo di ruolo attivo e dei relativi membri.

Ecco uno script PowerShell di esempio che implementa questi passaggi:

# Connect to Microsoft Graph
Connect-MgGraph -Scopes "Group.Read.All"

# Get role groups
$roleGroups = Get-RoleGroup

# Initialize lists
$roleGroupMemberships = @()

foreach ($group in $roleGroups) {
    $members = Get-RbacGroupMember -GroupId $group.Id
    foreach ($member in $members) {
        $roleGroupMemberships += [PSCustomObject]@{
            RoleGroupName = $group.DisplayName
            MemberName    = $member.DisplayName
            MemberType    = $member.ObjectType
        }
    }
}

# Generate HTML report
$roleGroupMemberships | ConvertTo-Html -Property RoleGroupName, MemberName, MemberType -Title "Purview Role Group Membership Report" | Out-File "PurviewRoleGroupReport.html"

Questo script ti aiuterà a generare un report completo sui membri dei gruppi di ruolo in Purview.

Comprendere i dati di output

Dopo aver eseguito lo script PowerShell, riceverai un report HTML con i dettagli dei membri dei gruppi di ruolo. Ecco come interpretare i dati in output:

Analizzando questi dati, puoi ottenere informazioni utili sull'appartenenza ai gruppi di ruolo all'interno della tua organizzazione. Queste informazioni sono fondamentali per garantire un corretto controllo degli accessi basato sui ruoli (RBAC) e per mantenere la conformità di sicurezza.

Tieni presente che l'accuratezza dei membri indicati nel report dipende dallo stato attuale del tuo ambiente Purview. Aggiornare regolarmente script e report ti aiuterà a restare informato su eventuali modifiche all'appartenenza ai gruppi di ruolo.

Best practice per il reporting

Pianifica report regolari

Per mantenere la conformità e la sicurezza, dovresti pianificare report regolari sui gruppi di ruolo di Purview. Il reporting periodico ti aiuta a sapere chi detiene ruoli di conformità e garantisce che la tua organizzazione rispetti i criteri di sicurezza. Ecco alcuni passaggi per pianificare questi report in modo efficace:

  1. Usa i cmdlet di PowerShell: sfrutta i cmdlet di PowerShell per automatizzare la generazione dei report. Puoi creare uno script che viene eseguito a intervalli prestabiliti.
  2. Configura Utilità di pianificazione: usa Utilità di pianificazione di Windows per eseguire automaticamente lo script PowerShell. In questo modo ricevi report aggiornati senza intervento manuale.
  3. Scegli i formati dei report: salva i report in formati sicuri come .PDF. Questo protegge le informazioni sensibili e rende più semplice la condivisione con gli utenti autorizzati.

Suggerimento: applica sempre il principio del privilegio minimo quando concedi l'accesso ai report. Questo riduce il rischio di accessi non autorizzati.

Analizza i dati dei report

Una volta generati i report, analizzare i dati diventa fondamentale. Capire chi fa parte dei gruppi di ruolo di conformità ti aiuta a individuare potenziali rischi per la sicurezza. Ecco alcune strategie per un'analisi efficace:

Seguendo queste best practice, puoi migliorare il processo di reporting e garantire che la tua organizzazione resti conforme agli standard di conformità di Microsoft 365.

In questa guida hai imparato a generare un report sui gruppi di ruolo di Purview usando PowerShell. Ti sei connesso a Microsoft Purview, hai autenticato le tue credenziali ed eseguito uno script PowerShell per recuperare le appartenenze ai gruppi di ruolo.

Il reporting regolare è essenziale per mantenere la sicurezza e la conformità. Ti aiuta a monitorare gli accessi e a individuare potenziali rischi.

Ti invito a integrare questo processo nei tuoi flussi di lavoro. Così rafforzerai la postura di sicurezza della tua organizzazione e garantirai la conformità agli standard di settore.

Domande frequenti

Che cos'è Microsoft Purview?

Microsoft Purview è una soluzione unificata di data governance che ti aiuta a gestire e proteggere i dati in ambienti diversi. Offre strumenti per la scoperta, la classificazione e la conformità dei dati.

Perché usare PowerShell per i report di Purview?

Usare PowerShell automatizza la generazione dei report, ti fa risparmiare tempo e riduce gli errori manuali. Ti permette di recuperare e gestire in modo efficiente le appartenenze ai gruppi di ruolo in Purview.

Con quale frequenza devo generare i report dei gruppi di ruoli di Purview?

Dovresti generare i report dei gruppi di ruoli di Purview regolarmente, idealmente ogni mese o ogni trimestre. Questa pratica ti aiuta a monitorare gli accessi e a mantenere la conformità ai criteri di sicurezza.

Che cosa succede se riscontro errori durante l'esecuzione dello script PowerShell?

Se riscontri errori, verifica le tue autorizzazioni, assicurati che tutti i moduli richiesti siano installati e controlla la connessione a Microsoft Purview. Leggi i messaggi di errore per indicazioni specifiche.

Posso personalizzare il formato del report?

Sì, puoi personalizzare il formato del report. Modifica lo script PowerShell per cambiare il formato di output, ad esempio generando file CSV o PDF, in base alle tue esigenze.

portale Purview e purview compliance

Questa FAQ si concentra sulla generazione di un report dei gruppi di ruoli di Purview con PowerShell e spiega le autorizzazioni correlate, la gestione dei ruoli e l'auditing in Microsoft Purview e Microsoft 365.

modulo PowerShell, autorizzazioni di Microsoft Purview e ruoli RBAC di Purview

La guida spiega come usare il modulo PowerShell e Microsoft Graph PowerShell SDK per elencare i membri dei gruppi di ruoli, esaminare le definizioni dei ruoli predefiniti e creare report per scenari di conformità ed eDiscovery.

Che cos'è un report dei gruppi di ruoli di Purview con PowerShell e perché dovresti crearne uno?

Un report dei gruppi di ruoli di Purview con PowerShell è un elenco generato (CSV o JSON) dei gruppi di ruoli, delle assegnazioni dei ruoli (ruoli RBAC di Purview e mapping dei ruoli predefiniti) e dei membri dei gruppi di ruoli nelle soluzioni di Microsoft Purview e nei servizi di Microsoft 365. Lo crei per verificare le autorizzazioni sui ruoli, controllare chi ha accesso ai ruoli privilegiati (ruolo di amministratore globale o ruolo di amministratore), supportare le revisioni di conformità e i casi di eDiscovery, oppure per alimentare il change control e le revisioni delle autorizzazioni di gestione dei rischi interni.

Quale modulo PowerShell usi per generare un report dei gruppi di ruoli di Microsoft Purview?

Usa una combinazione di moduli in base al tuo ambiente: Microsoft Graph PowerShell SDK per interrogare le assegnazioni dei ruoli nel portale di Microsoft Purview e i membri dei gruppi di ruoli, e il modulo Exchange Online Management o i moduli Security & Compliance per alcuni gruppi di ruoli specifici di Microsoft 365 ed eDiscovery. Microsoft a volte documenta esempi su Microsoft Learn per le attività di Purview data e del portale di Purview compliance.

Quali autorizzazioni servono per eseguire un report dei gruppi di ruoli di Purview con PowerShell?

In genere servono ruoli elevati, come il ruolo di amministratore globale o un ruolo di amministratore delegato con funzionalità di gestione dei ruoli, oppure autorizzazioni specifiche di Microsoft Purview, come i ruoli amministrativi nel portale di Purview (ruolo con privilegi o ruolo di amministratore). Per alcune query potrebbe essere necessario essere assegnati al gruppo di ruoli Organization Management o al gruppo di ruoli eDiscovery Manager. Quando usi Microsoft Graph PowerShell SDK per leggere le assegnazioni dei ruoli e le voci del log di controllo, assicurati di aver concesso il consenso alle autorizzazioni Graph necessarie.

Come posso elencare i membri dei gruppi di ruoli e i loro ruoli con Microsoft Graph PowerShell SDK?

Autenticati con autorizzazioni delegate o dell'app che includano roleManagement.read.* e Directory.Read.All, quindi interroga roleDefinitions e roleAssignments per associare i ruoli RBAC di Purview ai gruppi di ruoli ed elencare i relativi membri. Esporta i risultati in CSV per creare il report. Per i gruppi specifici di Exchange Online, come il gruppo di ruoli eDiscovery Manager, potrebbe servire il modulo Exchange Online Management per elencare i membri dei gruppi di ruoli e i privilegi di ricerca dei contenuti.

Posso includere nello stesso report i ruoli di eDiscovery e di protezione delle informazioni?

Sì. Combina i dati del portale di Microsoft Purview (per le soluzioni di Microsoft Purview e i ruoli di Microsoft Purview Data), dei servizi di Microsoft 365 (ricerca contenuti, casi di eDiscovery, ruolo eDiscovery Manager e gruppo di ruoli eDiscovery Manager) e delle assegnazioni di Microsoft Information Protection. Usa più moduli PowerShell o query Graph per aggregare le autorizzazioni sui ruoli, quindi normalizzale ed esportale come un unico report.

Come posso controllare le modifiche ai gruppi di ruoli e monitorare le autorizzazioni nel tempo?

Usa il log di controllo e gli eventi di accesso e di controllo di Azure AD (Microsoft Entra / Microsoft Entra ID), accessibili tramite Microsoft Graph PowerShell SDK o le API di auditing del portale di conformità di Purview. Pianifica esportazioni periodiche delle assegnazioni dei ruoli e degli elenchi dei membri dei gruppi di ruoli per rilevare le modifiche. Conservare snapshot storici consente di individuare le derive nel tempo e di raccogliere prove di conformità.

Quali sono le limitazioni comuni dei ruoli predefiniti da tenere d'occhio nei report sui gruppi di ruolo di Purview?

Le definizioni dei ruoli predefiniti possono essere molto ampie (ad esempio Global Administrator, Compliance Administrator) e concedere l'accesso a più ambiti di Purview, alle operazioni di eliminazione o ai dati privilegiati. Un report dovrebbe evidenziare le sovrapposizioni tra ruoli predefiniti, i gruppi di ruolo predefiniti e le assegnazioni che, di fatto, concedono un accesso elevato ai dati di Microsoft Purview, Microsoft Defender XDR o Microsoft 365 Copilot. Tieni presente che alcuni ruoli predefiniti non possono essere modificati, ma possono essere conteggiati e monitorati.

Come gestisco i gruppi di ruolo per l'amministrazione delegata e riduco l'esposizione dei ruoli privilegiati?

Individua i membri dei gruppi di ruolo assegnati a ruoli privilegiati e applica il principio del privilegio minimo: se possibile, crea ruoli personalizzati più limitati, rimuovi le appartenenze ai gruppi di ruolo non necessarie e usa i controlli di accesso di emergenza (break-glass) per gli accessi urgenti. Il report dovrebbe segnalare gli utenti del gruppo di ruolo Organization Management, i titolari di ruoli amministrativi e le entità servizio con assegnazioni di ruolo, così da ridurre il rischio legato ai ruoli privilegiati.

Dove posso trovare esempi e best practice per creare questi report e automatizzarli?

Consulta Microsoft Learn e la documentazione per gli esempi di PowerShell che utilizzano Microsoft Graph PowerShell SDK, il modulo Exchange Online Management e le API del portale di conformità. Le best practice includono l'automazione delle esportazioni pianificate, la registrazione delle voci del registro di controllo, la documentazione delle autorizzazioni dei ruoli come insieme di autorizzazioni e l'integrazione dei risultati nei flussi di lavoro di governance per la gestione dei ruoli, le revisioni delle autorizzazioni dei ruoli e gli audit di conformità.

Microsoft Purview Compliance

Related articles

RSS