Chiunque abbia mai gestito un tenant Microsoft 365 con qualche centinaio di utenti conosce bene la sensazione: aprire l’interfaccia di amministrazione, navigare tra pannelli e sottomenu e cercare di capire (in tempi ragionevoli) chi ha quale licenza, quante ne sono state assegnate e quante restano disponibili.
Un’operazione all’apparenza banale che ripetuta ogni mese o ogni volta che arriva una richiesta dall’ufficio acquisti diventa rapidamente una fonte di frustrazione silenziosa.
Il problema non è la complessità tecnica in sé ma la mancanza di automazione. Il portale di amministrazione è pensato per operazioni puntuali non per estrarre dati strutturati in modo ripetibile e affidabile.
Esportare manualmente un elenco di utenti con le relative assegnazioni di licenze significa tempo sprecato, rischio di errori e soprattutto un processo che non scala.
È qui che entra in gioco Microsoft Graph API: un’interfaccia unificata e potente che consente di interrogare l’intero ecosistema Microsoft 365 a livello programmatico ottenendo in pochi secondi le stesse informazioni che il portale restituisce in molti clic.
Con le giuste chiamate API è possibile costruire un inventario completo e aggiornato di tutti gli utenti del tenant corredato delle SKU di licenza assegnate dei service plan attivi e dello stato di ogni sottoscrizione.
In questo articolo vedremo come automatizzare l’intero processo dall’autenticazione tramite un’applicazione registrata su Azure Active Directory fino alla generazione di un export strutturato e pronto per essere analizzato o integrato nei propri strumenti di reporting.
Niente più copia-incolla dal portale: solo dati, script e un inventario sempre aggiornato con un singolo comando.
PREREQUISITI
Sul PC da cui si eseguirà lo script:
- Windows con PowerShell 5.1 o superiore (già incluso in Windows 10/11)
- Connessione internet
- Modulo Microsoft.Graph installato
Su Azure / Microsoft 365:
- Accesso al portale Azure (portal.azure.com) con un account Global Admin o Application Admin
- Un’App Registration creata in Azure AD con:
- Le permission di tipo Application (non Delegated) per User.Read.All, Directory.Read.All e Organization.Read.All
- L’Admin Consent concesso per tutte e tre le permission
- Un Client Secret generato e copiato
- I tre valori disponibili: Tenant ID, Client ID e Client Secret
Permessi minimi sull’account che crea l’App Registration:
- Ruolo Global Administrator oppure Application Administrator nel tenant M365
CREAZIONE E CONFIGURAZIONE DELL’APP SUL TENANT AZURE
Richiamare da un qualsiasi browser portal.azure.com
Cercare App Registration
Cliccare su New Registration
Dare un nome all’App (Es: ExportLicense) quindi cliccare su Register
Copiare l’Application (client) ID e il Directory (tenant) ID
Cliccare su Add a certificate or secret
Cliccare su Certificates & Secrets quindi New Client Secret
Inserire la Descrizione e la Scadenza quindi cliccare al fondo della pagina Add
Copiare il Value della Secret
Cliccare su API Permissions quindi Add a Permissions
Selezionare Microsoft Graph
Cliccare su Application Permissions
Cercare il valore User.Read.All quindi selezionarlo
Cercare il valore Directory.Read.All quindi selezionarlo
Cercare il valore Organization.Read.Al quindi selezionarlo
Al fondo della pagina cliccare su Add Permissions
Da questa schermata è possibile notare che le permissions non sono state Consentite da Admin
Cliccare su Grant Admin Consent quindi accertiarsi che tutte le permissions abbiano lo stato Granted col bollino verde
INSTALLAZIONE DEL MODULO MICROSOFT GRAPH
Per poter utilizzare lo script è necessario installare il modulo Microsoft.Graph dalla gallery ufficiale di Microsoft (PowerShell Gallery) con il comando:
|
0 |
install-Module Microsoft.Graph -Scope CurrentUser -Force
|
In pratica senza questo comando i cmdlet come Connect-MgGraph, Get-MgUser, Get-MgSubscribedSku non esisterebbero in PowerShell e lo script non potrebbe girare.
💡 Si tratta di un’operazione sicura e ufficiale: il modulo è pubblicato e mantenuto direttamente da Microsoft. Scarica circa 200 MB di file nella cartella profilo dell’utente (C:\Users\tuonomeutente\Documents\PowerShell\Modules), senza modificare file di sistema.
⚠️ Potrebbero volerci anche 10/15 minuti al termine dell’installazione. Non chiudere o bloccare la finestra Powershell
SCRIPT PER IL REPERIMENTO DELLE SKU DEL TENANT
La prima cosa da fare è eseguire uno script rapido che interroga il tuo tenant e restituisce tutte le SKU con il loro codice tecnico da aggiungere allo script successivo.
Lo script fa due cose:
Mostra una tabella con tutte le SKU (codice, GUID, totali, usate)
Genera automaticamente il blocco $skuNames pronto da copiare in Export-M365Licenses.ps1 con i codici tecnici come placeholder — dovrai solo sostituire il valore a destra con il nome leggibile che preferisci per quelle SKU che non riconosci.
Di seguito il listato dello script Powershell:
|
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
|
# ============================================================
# Get-TenantSKUs.ps1
# Elenca tutte le SKU presenti nel tenant
# ============================================================
# =====================================================================
# CONFIGURA QUI LE TUE CREDENZIALI (da Azure App Registration)
# =====================================================================
$TenantId = "INSERISCI-IL-TUO-TENANT-ID"
$ClientId = "INSERISCI-IL-TUO-CLIENT-ID"
$ClientSecret = "INSERISCI-IL-TUO-CLIENT-SECRET"
# =====================================================================
Import-Module Microsoft.Graph.Authentication -ErrorAction Stop
Import-Module Microsoft.Graph.Identity.DirectoryManagement -ErrorAction Stop
# Autenticazione
$tokenBody = @{
grant_type = "client_credentials"
client_id = $ClientId
client_secret = $ClientSecret
scope = "https://graph.microsoft.com/.default"
}
$tokenResponse = Invoke-RestMethod `
-Uri "https://login.microsoftonline.com/$TenantId/oauth2/v2.0/token" `
-Method POST `
-ContentType "application/x-www-form-urlencoded" `
-Body $tokenBody
$secureToken = $tokenResponse.access_token | ConvertTo-SecureString -AsPlainText -Force
Connect-MgGraph -AccessToken $secureToken -NoWelcome
# Recupero SKU
$skus = Get-MgSubscribedSku -All | Sort-Object SkuPartNumber
Write-Host "`n=== SKU presenti nel tenant ($($skus.Count) trovate) ===`n" -ForegroundColor Cyan
# Mostra tabella a schermo
$skus | Format-Table @(
@{Label="Codice SKU"; Expression={$_.SkuPartNumber}; Width=45},
@{Label="SkuId (GUID)"; Expression={$_.SkuId}; Width=38},
@{Label="Totali"; Expression={$_.PrepaidUnits.Enabled}; Width=8},
@{Label="Usate"; Expression={$_.ConsumedUnits}; Width=8}
) -AutoSize
# Genera il blocco $skuNames da copiare nello script principale
Write-Host "`n--- COPIA IL BLOCCO SEGUENTE IN Export-M365Licenses.ps1 ---`n" -ForegroundColor Yellow
Write-Host '$skuNames = @{' -ForegroundColor Green
foreach ($sku in $skus) {
$padding = " " * [Math]::Max(1, 45 - $sku.SkuPartNumber.Length)
Write-Host " `"$($sku.SkuPartNumber)`"$padding= `"$($sku.SkuPartNumber)`"" -ForegroundColor Green
}
Write-Host "}" -ForegroundColor Green
Write-Host "`n--- Fine blocco ---`n" -ForegroundColor Yellow
Disconnect-MgGraph
|
Salvare il file col nome Get-TenantSKUs.ps1
Sostituire le seguenti righe con i codici presi in precedenza:
$TenantId = “INSERISCI-IL-TUO-TENANT-ID”
$ClientId = “INSERISCI-IL-TUO-CLIENT-ID”
$ClientSecret = “INSERISCI-IL-TUO-CLIENT-SECRET”
⚠️ Il secret è visibile solo al momento della creazione. Se non l’hai copiato, dovrai eliminarlo e crearne uno nuovo.
COPIA DELLE SKU NELLO SCRIPT
Di seguito un output che potremmo vedere dopo aver eseguito il Powershell Get-TenantSKUs.ps1:
|
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
|
--- COPIA IL BLOCCO SEGUENTE IN Export-M365Licenses.ps1 ---
$skuNames = @{
"CCIBOTS_PRIVPREV_VIRAL" = "CCIBOTS_PRIVPREV_VIRAL"
"CPC_E_8C_32GB_512GB" = "CPC_E_8C_32GB_512GB"
"D365_SALES_ENT_ATTACH" = "D365_SALES_ENT_ATTACH"
"DYN365_BUSCENTRAL_DEVICE" = "DYN365_BUSCENTRAL_DEVICE"
"DYN365_BUSCENTRAL_ESSENTIAL" = "DYN365_BUSCENTRAL_ESSENTIAL"
"DYN365_BUSCENTRAL_TEAM_MEMBER" = "DYN365_BUSCENTRAL_TEAM_MEMBER"
"DYN365_ENTERPRISE_P1_IW" = "DYN365_ENTERPRISE_P1_IW"
"DYN365_ENTERPRISE_SALES" = "DYN365_ENTERPRISE_SALES"
"DYN365_TEAM_MEMBERS" = "DYN365_TEAM_MEMBERS"
"Dynamics_365_Sales_Premium_Viral_Trial" = "Dynamics_365_Sales_Premium_Viral_Trial"
"EMSPREMIUM" = "EMSPREMIUM"
"EXCHANGEENTERPRISE" = "EXCHANGEENTERPRISE"
"EXCHANGESTANDARD" = "EXCHANGESTANDARD"
"FLOW_FREE" = "FLOW_FREE"
"FLOW_PER_USER" = "FLOW_PER_USER"
"IDENTITY_THREAT_PROTECTION" = "IDENTITY_THREAT_PROTECTION"
"MCOCAP" = "MCOCAP"
"MCOEV" = "MCOEV"
"MCOPSTN_5" = "MCOPSTN_5"
"MCOPSTN2" = "MCOPSTN2"
"Microsoft_365_Copilot" = "Microsoft_365_Copilot"
"MICROSOFT_BUSINESS_CENTER" = "MICROSOFT_BUSINESS_CENTER"
"Microsoft_Cloud_for_Sustainability_vTrial" = "Microsoft_Cloud_for_Sustainability_vTrial"
"Microsoft_Entra_Suite" = "Microsoft_Entra_Suite"
"Microsoft_Teams_EEA_New" = "Microsoft_Teams_EEA_New"
"Microsoft_Teams_Premium" = "Microsoft_Teams_Premium"
"Microsoft_Teams_Rooms_Pro" = "Microsoft_Teams_Rooms_Pro"
"Microsoft_Teams_Rooms_Pro_without_Audio_Conferencing" = "Microsoft_Teams_Rooms_Pro_without_Audio_Conferencing"
"O365_BUSINESS_ESSENTIALS" = "O365_BUSINESS_ESSENTIALS"
"O365_BUSINESS_PREMIUM" = "O365_BUSINESS_PREMIUM"
"O365_w/o Teams Bundle_M3" = "O365_w/o Teams Bundle_M3"
"O365_w/o_Teams_Bundle_M5" = "O365_w/o_Teams_Bundle_M5"
"PBI_PREMIUM_PER_USER" = "PBI_PREMIUM_PER_USER"
"PHONESYSTEM_VIRTUALUSER" = "PHONESYSTEM_VIRTUALUSER"
"Power_Automate_per_process" = "Power_Automate_per_process"
"POWER_BI_PRO_DEPT" = "POWER_BI_PRO_DEPT"
"POWER_BI_STANDARD" = "POWER_BI_STANDARD"
"Power_Pages_vTrial_for_Makers" = "Power_Pages_vTrial_for_Makers"
"Power_Virtual_Agents" = "Power_Virtual_Agents"
"POWERAPPS_DEV" = "POWERAPPS_DEV"
"POWERAPPS_PER_USER" = "POWERAPPS_PER_USER"
"POWERAPPS_VIRAL" = "POWERAPPS_VIRAL"
"POWERAUTOMATE_ATTENDED_RPA" = "POWERAUTOMATE_ATTENDED_RPA"
"POWERAUTOMATE_ATTENDED_RPA_DEPT" = "POWERAUTOMATE_ATTENDED_RPA_DEPT"
"PROJECT_P1" = "PROJECT_P1"
"PROJECTPREMIUM" = "PROJECTPREMIUM"
"PROJECTPROFESSIONAL" = "PROJECTPROFESSIONAL"
"Remote_Help_AddOn" = "Remote_Help_AddOn"
"SPE_E3" = "SPE_E3"
"SPE_E5" = "SPE_E5"
"STANDARDPACK" = "STANDARDPACK"
"STREAM" = "STREAM"
"THREAT_INTELLIGENCE" = "THREAT_INTELLIGENCE"
"UNIVERSAL_PRINT" = "UNIVERSAL_PRINT"
"VIRTUAL_AGENT_USL" = "VIRTUAL_AGENT_USL"
"VISIOCLIENT" = "VISIOCLIENT"
"WINDOWS_STORE" = "WINDOWS_STORE"
}
--- Fine blocco ---
|
A questo punto prima di copiare le SKU nello script modificarle mettendo a destra dell’uguale una descrizione parlante del software:
|
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
|
"CCIBOTS_PRIVPREV_VIRAL" = "Copilot Studio - Preview virale gratuita"
"CPC_E_8C_32GB_512GB" = "Windows 365 Enterprise (8 vCPU, 32GB RAM, 512GB)"
"D365_SALES_ENT_ATTACH" = "Dynamics 365 Sales Enterprise (Attach)"
"DYN365_BUSCENTRAL_DEVICE" = "Dynamics 365 Business Central - Licenza Dispositivo"
"DYN365_BUSCENTRAL_ESSENTIAL" = "Dynamics 365 Business Central Essentials"
"DYN365_BUSCENTRAL_TEAM_MEMBER" = "Dynamics 365 Business Central - Team Member"
"DYN365_ENTERPRISE_P1_IW" = "Dynamics 365 Customer Engagement Plan"
"DYN365_ENTERPRISE_SALES" = "Dynamics 365 Sales Enterprise"
"DYN365_TEAM_MEMBERS" = "Dynamics 365 Team Members"
"Dynamics_365_Sales_Premium_Viral_Trial" = "Dynamics 365 Sales Premium - Trial virale"
"EMSPREMIUM" = "Enterprise Mobility + Security E5"
"EXCHANGEENTERPRISE" = "Exchange Online (Piano 2)"
"EXCHANGESTANDARD" = "Exchange Online (Piano 1)"
"FLOW_PER_USER" = "Power Automate per Utente"
"IDENTITY_THREAT_PROTECTION" = "Microsoft Entra ID P2 + Defender for Identity"
"MCOCAP" = "Microsoft Teams Shared Devices (CAP)"
"MCOPSTN_5" = "Teams Calling Plan per zona (Pay-as-you-go)"
"MCOPSTN2" = "Teams Calling Plan Internazionale"
"Microsoft_365_Copilot" = "Microsoft 365 Copilot"
"MICROSOFT_BUSINESS_CENTER" = "Microsoft Business Center"
"Microsoft_Cloud_for_Sustainability_vTrial" = "Microsoft Cloud for Sustainability - Trial"
"Microsoft_Entra_Suite" = "Microsoft Entra Suite"
"Microsoft_Teams_EEA_New" = "Microsoft Teams (Area Economica Europea)"
"Microsoft_Teams_Premium" = "Microsoft Teams Premium"
"Microsoft_Teams_Rooms_Pro" = "Microsoft Teams Rooms Pro"
"Microsoft_Teams_Rooms_Pro_without_Audio_Conferencing" = "Microsoft Teams Rooms Pro (senza Audioconferenza)"
"O365_w/o Teams Bundle_M3" = "Microsoft 365 E3 senza Teams"
"O365_w/o_Teams_Bundle_M5" = "Microsoft 365 E5 senza Teams"
"PBI_PREMIUM_PER_USER" = "Power BI Premium per Utente"
"PHONESYSTEM_VIRTUALUSER" = "Teams Phone - Utente virtuale (gratuito)"
"Power_Automate_per_process" = "Power Automate per Processo"
"POWER_BI_PRO_DEPT" = "Power BI Pro (Dipartimentale)"
"Power_Pages_vTrial_for_Makers" = "Power Pages - Trial per sviluppatori"
"Power_Virtual_Agents" = "Copilot Studio (ex Power Virtual Agents)"
"POWERAPPS_DEV" = "Power Apps per Sviluppatori (gratuito)"
"POWERAPPS_PER_USER" = "Power Apps per Utente"
"POWERAPPS_VIRAL" = "Power Apps - Trial virale gratuita"
"POWERAUTOMATE_ATTENDED_RPA" = "Power Automate con RPA Attended"
"POWERAUTOMATE_ATTENDED_RPA_DEPT" = "Power Automate con RPA Attended (Dipartimentale)"
"PROJECT_P1" = "Project Plan 1"
"Remote_Help_AddOn" = "Intune Remote Help (Add-on)"
"SPE_E3" = "Microsoft 365 E3 (Suite)"
"SPE_E5" = "Microsoft 365 E5 (Suite)"
"STREAM" = "Microsoft Stream (Piano classico)"
"THREAT_INTELLIGENCE" = "Microsoft Defender for Office 365 (Piano 2)"
"UNIVERSAL_PRINT" = "Universal Print"
"VIRTUAL_AGENT_USL" = "Copilot Studio - Sessioni aggiuntive"
"WINDOWS_STORE" = "Microsoft Store for Business"
|
SCRIPT CHE ESPORTA LE LICENZE CON LE RELATIVE UTENZE ASSEGNATARIE
Di seguito lo script PowerShell che usa Microsoft Graph per estrarre tutte le licenze del tenant con gli utenti associati e li esporta in CSV (apribile direttamente in Excel).
E’ possibile eseguire lo script nelle due modalità di seguito:
|
0
1
|
# Esegui con percorso predefinito (crea un file con data/ora automatica)
.\Export-M365Licenses.ps1
|
|
0
1
|
# Oppure specifica dove salvare il file
.\Export-M365Licenses.ps1 -OutputPath "C:\Report\licenze.csv"
|
Il File CSV contiene:
Nome Utente / UPN: Identità dell’utente
Account Abilitato: Se l’account è attivo
Reparto / Mansione: Info organizzative
Licenza / Codice SKU: Nome leggibile e codice tecnico
Company Name: Azienda
Totali / Consumate / Disponibili: Contatori per ogni SKU nel tenant
Una riga per ogni combinazione utente–licenza: se un utente ha 3 licenze, avrà 3 righe. Così è possibile filtrare e pivotare facilmente in Excel.
Di seguito lo script Powershell:
|
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
|
# ============================================================
# Export-M365Licenses.ps1 (v1)
# Compatibile con tutte le versioni del modulo Microsoft.Graph
# ============================================================
param(
[string]$OutputPath = ".\M365_Licenze_$(Get-Date -Format 'yyyyMMdd_HHmm').csv"
)
# =====================================================================
# CONFIGURA QUI LE TUE CREDENZIALI (da Azure App Registration)
# =====================================================================
$TenantId = "INSERISCI-IL-TUO-TENANT-ID"
$ClientId = "INSERISCI-IL-TUO-CLIENT-ID"
$ClientSecret = "INSERISCI-IL-TUO-CLIENT-SECRET"
# =====================================================================
# ── 0. VERIFICA MODULO ───────────────────────────────────────
Write-Host "`n[0/4] Verifica modulo Microsoft.Graph..." -ForegroundColor Cyan
if (-not (Get-Module -ListAvailable -Name Microsoft.Graph.Authentication)) {
Write-Host " Modulo non trovato. Installazione in corso..." -ForegroundColor Yellow
Install-Module Microsoft.Graph -Scope CurrentUser -Force -AllowClobber
}
Import-Module Microsoft.Graph.Authentication -ErrorAction Stop
Import-Module Microsoft.Graph.Users -ErrorAction Stop
Import-Module Microsoft.Graph.Identity.DirectoryManagement -ErrorAction Stop
Write-Host " Moduli caricati." -ForegroundColor Green
# ── 1. CONNESSIONE con TOKEN OAUTH DIRETTO ───────────────────
Write-Host "[1/4] Richiesta token OAuth a Microsoft..." -ForegroundColor Cyan
try {
$tokenBody = @{
grant_type = "client_credentials"
client_id = $ClientId
client_secret = $ClientSecret
scope = "https://graph.microsoft.com/.default"
}
$tokenResponse = Invoke-RestMethod `
-Uri "https://login.microsoftonline.com/$TenantId/oauth2/v2.0/token" `
-Method POST `
-ContentType "application/x-www-form-urlencoded" `
-Body $tokenBody `
-ErrorAction Stop
$secureToken = $tokenResponse.access_token | ConvertTo-SecureString -AsPlainText -Force
Connect-MgGraph -AccessToken $secureToken -NoWelcome -ErrorAction Stop
Write-Host " Connessione riuscita!" -ForegroundColor Green
}
catch {
Write-Host "`n ERRORE di autenticazione:" -ForegroundColor Red
Write-Host " $($_.Exception.Message)" -ForegroundColor Red
exit 1
}
# ── 2. MAPPA SKU → NOME LEGGIBILE ───────────────────────────
Write-Host "[2/4] Recupero catalogo licenze..." -ForegroundColor Cyan
$skuNames = @{
"AAD_PREMIUM" = "Azure AD Premium P1"
"AAD_PREMIUM_P2" = "Azure AD Premium P2"
"ATP_ENTERPRISE" = "Microsoft Defender for Office 365 (Plan 1)"
"ENTERPRISEPACK" = "Microsoft 365 E3"
"ENTERPRISEPREMIUM" = "Microsoft 365 E5"
"ENTERPRISEPREMIUM_NOPSTNCONF" = "Microsoft 365 E5 (senza audioconferenza)"
"FLOW_FREE" = "Microsoft Power Automate Free"
"INTUNE_A" = "Microsoft Intune"
"M365EDU_A3_FACULTY" = "Microsoft 365 A3 (Docenti)"
"M365EDU_A3_STUDENT" = "Microsoft 365 A3 (Studenti)"
"M365EDU_A5_FACULTY" = "Microsoft 365 A5 (Docenti)"
"MCOEV" = "Microsoft Teams Phone Standard"
"MCOMEETADV" = "Microsoft 365 Audio Conferencing"
"MCOSTANDARD" = "Skype for Business Online (Plan 2)"
"O365_BUSINESS_ESSENTIALS" = "Microsoft 365 Business Basic"
"O365_BUSINESS_PREMIUM" = "Microsoft 365 Business Standard"
"OFFICESUBSCRIPTION" = "Microsoft 365 Apps for Enterprise"
"POWER_BI_PRO" = "Power BI Pro"
"POWER_BI_STANDARD" = "Power BI (gratuito)"
"PROJECTPREMIUM" = "Project Plan 5"
"PROJECTPROFESSIONAL" = "Project Plan 3"
"SPB" = "Microsoft 365 Business Premium"
"STANDARDPACK" = "Microsoft 365 E1 (Office 365 E1)"
"VISIOCLIENT" = "Visio Plan 2"
"VISIOONLINE_PLAN1" = "Visio Plan 1"
"WIN10_PRO_ENT_SUB" = "Windows 10/11 Enterprise E3"
"CCIBOTS_PRIVPREV_VIRAL" = "Copilot Studio - Preview virale gratuita"
"CPC_E_8C_32GB_512GB" = "Windows 365 Enterprise (8 vCPU, 32GB RAM, 512GB)"
"D365_SALES_ENT_ATTACH" = "Dynamics 365 Sales Enterprise (Attach)"
"DYN365_BUSCENTRAL_DEVICE" = "Dynamics 365 Business Central - Licenza Dispositivo"
"DYN365_BUSCENTRAL_ESSENTIAL" = "Dynamics 365 Business Central Essentials"
"DYN365_BUSCENTRAL_TEAM_MEMBER" = "Dynamics 365 Business Central - Team Member"
"DYN365_ENTERPRISE_P1_IW" = "Dynamics 365 Customer Engagement Plan"
"DYN365_ENTERPRISE_SALES" = "Dynamics 365 Sales Enterprise"
"DYN365_TEAM_MEMBERS" = "Dynamics 365 Team Members"
"Dynamics_365_Sales_Premium_Viral_Trial" = "Dynamics 365 Sales Premium - Trial virale"
"EMSPREMIUM" = "Enterprise Mobility + Security E5"
"EXCHANGEENTERPRISE" = "Exchange Online (Piano 2)"
"EXCHANGESTANDARD" = "Exchange Online (Piano 1)"
"FLOW_PER_USER" = "Power Automate per Utente"
"IDENTITY_THREAT_PROTECTION" = "Microsoft Entra ID P2 + Defender for Identity"
"MCOCAP" = "Microsoft Teams Shared Devices (CAP)"
"MCOPSTN_5" = "Teams Calling Plan per zona (Pay-as-you-go)"
"MCOPSTN2" = "Teams Calling Plan Internazionale"
"Microsoft_365_Copilot" = "Microsoft 365 Copilot"
"MICROSOFT_BUSINESS_CENTER" = "Microsoft Business Center"
"Microsoft_Cloud_for_Sustainability_vTrial" = "Microsoft Cloud for Sustainability - Trial"
"Microsoft_Entra_Suite" = "Microsoft Entra Suite"
"Microsoft_Teams_EEA_New" = "Microsoft Teams (Area Economica Europea)"
"Microsoft_Teams_Premium" = "Microsoft Teams Premium"
"Microsoft_Teams_Rooms_Pro" = "Microsoft Teams Rooms Pro"
"Microsoft_Teams_Rooms_Pro_without_Audio_Conferencing" = "Microsoft Teams Rooms Pro (senza Audioconferenza)"
"O365_w/o Teams Bundle_M3" = "Microsoft 365 E3 senza Teams"
"O365_w/o_Teams_Bundle_M5" = "Microsoft 365 E5 senza Teams"
"PBI_PREMIUM_PER_USER" = "Power BI Premium per Utente"
"PHONESYSTEM_VIRTUALUSER" = "Teams Phone - Utente virtuale (gratuito)"
"Power_Automate_per_process" = "Power Automate per Processo"
"POWER_BI_PRO_DEPT" = "Power BI Pro (Dipartimentale)"
"Power_Pages_vTrial_for_Makers" = "Power Pages - Trial per sviluppatori"
"Power_Virtual_Agents" = "Copilot Studio (ex Power Virtual Agents)"
"POWERAPPS_DEV" = "Power Apps per Sviluppatori (gratuito)"
"POWERAPPS_PER_USER" = "Power Apps per Utente"
"POWERAPPS_VIRAL" = "Power Apps - Trial virale gratuita"
"POWERAUTOMATE_ATTENDED_RPA" = "Power Automate con RPA Attended"
"POWERAUTOMATE_ATTENDED_RPA_DEPT" = "Power Automate con RPA Attended (Dipartimentale)"
"PROJECT_P1" = "Project Plan 1"
"Remote_Help_AddOn" = "Intune Remote Help (Add-on)"
"SPE_E3" = "Microsoft 365 E3 (Suite)"
"SPE_E5" = "Microsoft 365 E5 (Suite)"
"STREAM" = "Microsoft Stream (Piano classico)"
"THREAT_INTELLIGENCE" = "Microsoft Defender for Office 365 (Piano 2)"
"UNIVERSAL_PRINT" = "Universal Print"
"VIRTUAL_AGENT_USL" = "Copilot Studio - Sessioni aggiuntive"
"WINDOWS_STORE" = "Microsoft Store for Business"
}
$subscribedSkus = Get-MgSubscribedSku -All
$skuMap = @{}
foreach ($sku in $subscribedSkus) {
$friendlyName = if ($skuNames.ContainsKey($sku.SkuPartNumber)) {
$skuNames[$sku.SkuPartNumber]
} else {
$sku.SkuPartNumber
}
$skuMap[$sku.SkuId] = @{
Nome = $friendlyName
Codice = $sku.SkuPartNumber
Totali = $sku.PrepaidUnits.Enabled
Consumate = $sku.ConsumedUnits
Disponibili = $sku.PrepaidUnits.Enabled - $sku.ConsumedUnits
}
}
# ── 3. RECUPERO UTENTI E LICENZE ────────────────────────────
Write-Host "[3/4] Recupero utenti e licenze assegnate..." -ForegroundColor Cyan
$users = Get-MgUser -All -Property `
"Id,DisplayName,UserPrincipalName,AccountEnabled,CompanyName,Department,JobTitle,AssignedLicenses,UsageLocation"
$results = [System.Collections.Generic.List[PSCustomObject]]::new()
foreach ($user in $users) {
if ($user.AssignedLicenses.Count -eq 0) {
$results.Add([PSCustomObject]@{
"Nome Utente" = $user.DisplayName
"UPN" = $user.UserPrincipalName
"Account Abilitato" = $user.AccountEnabled
"Azienda" = $user.CompanyName
"Reparto" = $user.Department
"Mansione" = $user.JobTitle
"Paese Utilizzo" = $user.UsageLocation
"Licenza" = "(nessuna)"
"Codice SKU" = ""
"Totali Tenant" = ""
"Consumate" = ""
"Disponibili" = ""
})
continue
}
foreach ($lic in $user.AssignedLicenses) {
$skuInfo = $skuMap[$lic.SkuId]
$results.Add([PSCustomObject]@{
"Nome Utente" = $user.DisplayName
"UPN" = $user.UserPrincipalName
"Account Abilitato" = $user.AccountEnabled
"Azienda" = $user.CompanyName
"Reparto" = $user.Department
"Mansione" = $user.JobTitle
"Paese Utilizzo" = $user.UsageLocation
"Licenza" = if ($skuInfo) { $skuInfo.Nome } else { $lic.SkuId }
"Codice SKU" = if ($skuInfo) { $skuInfo.Codice } else { "" }
"Totali Tenant" = if ($skuInfo) { $skuInfo.Totali } else { "" }
"Consumate" = if ($skuInfo) { $skuInfo.Consumate } else { "" }
"Disponibili" = if ($skuInfo) { $skuInfo.Disponibili } else { "" }
})
}
}
# ── 4. ESPORTAZIONE CSV ──────────────────────────────────────
Write-Host "[4/4] Esportazione in CSV..." -ForegroundColor Cyan
$results | Export-Csv -Path $OutputPath -NoTypeInformation -Encoding UTF8 -Delimiter ";"
Write-Host "`n Esportazione completata!" -ForegroundColor Green
Write-Host " File salvato in : $OutputPath"
Write-Host " Righe esportate : $($results.Count)"
Write-Host " Utenti trovati : $($users.Count)"
Write-Host " SKU nel tenant : $($subscribedSkus.Count)`n"
Disconnect-MgGraph
|
Se tutto è andato a buon fine dovremmo vedere una schermata come quella dell’immagine sovrastante
ANALISI DEL FILE CSV
Nel file CSV trovi una riga per ogni combinazione utente-licenza. Le colonne sono:
Nome Utente: Mario Rossi
UPN: [email protected]
Account Abilitato: True / False
Azienda: Società 1
Reparto: IT
Mansione: System Administrator
Paese Utilizzo: IT
Licenza: Microsoft 365 E3
Codice SKU: ENTERPRISEPACK
Totali Tenant: 50
Consumate: 43
Disponibili: 7
Di seguito uno screenshot del file excel
Download “Export-M365Licenses.zip” Export-M365Licenses.zip – Scaricato 0 volte – 3,68 KB
Download “Get-TenantSKUs.zip” Get-TenantSKUs.zip – Scaricato 0 volte – 1,19 KB
0 commenti