Tutto nasce da questo commento e dall’esigenza – anche del sottoscritto – di tirare fuori a cadenza più o meno regolare lo stato delle licenze usate sul tenant di Office 365. Dato che con il passaggio a PowerShell 7 ci sono alcune istruzioni che non portano più a nulla (e per le quali toccherebbe andare a utilizzare una vecchia versione di PowerShell), mi sono documentato per capire come aggirare l’ostacolo e tornare in possesso del mio report licenze su richiesta. Ce l’ho fatta, si passa per Microsoft Graph e cambia giusto qualcosa rispetto al passato, vediamo insieme cosa.
Microsoft Graph
Va necessariamente installato tra i moduli caricati e pronti per essere richiamati tramite PowerShell 7. Nulla di più semplice. Lo prevede lo script che ti mostrerà tra poco ma tu puoi portarti già avanti e installare il necessario (installazione dei moduli e primo collegamento):
Install-Module Microsoft.Graph Connect-MgGraph
Un rapido check (Get-Module) ti dovrebbe mostrare cosa c’è ora a bordo di PowerShell 7 (insieme al resto dei moduli precedentemente già presenti):
ModuleType Version Name ExportedCommands
---------- ------- ---- ----------------
Script 1.9.2 Microsoft.Graph.Authentication {Add-MgEnvironment, Connect-MgGraph, Disconnect-MgGraph, Get-MgContex…
Script 1.9.2 Microsoft.Graph.Users {Get-MgUser, Get-MgUserCreatedObject, Get-MgUserCreatedObjectByRef, G…
Script 1.9.2 Microsoft.Graph.Users.Actions {Add-MgUserPendingAccessReviewInstanceDecision, Clear-MgUserAndBlockM…
Lo script
Liberamente ispirato a quanto riportato dall’articolo sul blog di Anthony Howell e unito a quanto già fatto in passato per la vecchia versione di PowerShell, questo è il risultato della modifica che porta al desiderato CSV che successivamente puoi gestire comodamente in Microsoft Excel:
<#
OFFICE 365: "User License Report" for PowerShell 7
---------------------------------------------------------------------------------------------------
Autore originale: Kombaiah Murugan (8 feb. 2016)
URL originale: http://www.morgantechspace.com/2016/02/get-all-licensed-office-365-users-with-powershell.html
Modifiche: GSolone
Versione: 0.9
Utilizzo: .\ExportMsolAccountSku.ps1
(opzionale, posizione CSV) .\ExportMsolAccountSku.ps1 -CSV C:\Licenze.csv
(opzionale, dominio da filtrare) .\ExportMsolAccountSku.ps1 -domain contoso.com
Info: https://gioxx.org/tag/o365-powershell
Fonti utilizzate: https://theposhwolf.com/howtos/Set-MgUserLicense-PowerShell-Assign-O365-License/
Office 365 License Reporting and Management using PowerShell
Ho approfittato di questa parziale riscrittura per integrare una ben più nutrita lista di mappatura tra SkuPartNumber e nome “amichevole” del prodotto, e per questo ringrazio la fantastica base di partenza che ho trovato su o365reports.com/2021/11/23/office-365-license-reporting-and-management-using-powershell. L’ho pubblicata a mia volta – leggermente modificata – su Gist, puoi trovarla qui in caso di necessità: gist.github.com/gioxx/f3480f4eb99929b304d4936248b90e11.
Lo script che vedi poco sopra è disponibile anch’esso su GitHub, all’interno del repository dedicato agli script PowerShell per Office 365, si chiama – molto banalmente – ExportMsolAccountSku-PS7.ps1. Una volta lanciato recupererà tutti gli utenti del tenant provvisti di licenza e li verificherà tramite Graph per ottenere il dettaglio delle licenze assegnate.
Il CSV prodotto conterrà una riga per ciascuna licenza (quindi le righe per singolo utente ti risulteranno molteplici se quell’utente sfrutta più di una licenza). La modifica nel caso tu volessi su riga unica gli utenti (e quindi avere un campo licenze più corposo) è fattibile oltre che tutto sommato semplice, prendi ispirazione dal vecchio script che contiene (anche se commentato) il riferimento a quel vecchio metodo che ormai non uso più da tanto tempo.
Aggiornamento del 23/11/22
Ho dovuto riutilizzare lo script che però, in fase di avvio e caricamento dei moduli necessari, ha cominciato a mostrare un errore a video che ne causava l’inutilizzabilità:
Connect-MgGraph: Could not load type 'System.IdentityModel.Tokens.Jwt.JwtSecurityTokenHandler' from assembly 'System.IdentityModel.Tokens.Jwt, Version=4.0.20622.1351, Culture=neutral, PublicKeyToken=XXXXXXXXXXXXXXXX'.
Ho fatto alcune ricerche in merito e scoperto che caricare il modulo MSOnline prima di Microsoft Graph può causare questa anomalia. Se dovessi aver già caricato i moduli Graph (lo scopri lanciando un Get-Module da PowerShell) puoi rimuoverli in blocco lanciando questo comando:
Get-Module | foreach { if ($_.Name -like "Microsoft.Graph.*") { Remove-Module $_.Name -Force } }
A questo punto dovrai fare lo stesso con i moduli MSOnline (ti basta cambiare Microsoft.Graph.* in MSOnline) e rilanciare il codice poco sopra), per poi utilizzare l’ultima versione dello script di estrazione licenze che ho caricato su GitHub, la quale inverte l’ordine di caricamento dei moduli e chiama prima Graph rispetto agli MS Online.
Se il problema continua a presentarsi puoi disinstallare il modulo MSOnline dalla PowerShell 7 e lasciare installato quello predefinito di sistema sulla PowerShell integrata di Windows 10/11, lo script infatti richiama l’uso di quello tramite Import-Module MSOnline -UseWindowsPowershell.
Per disinstallare MSOnline da PowerShell 7 basterà lanciare un:
Uninstall-Module MSOnline
Aggiornamento del 28/9/2022
Ho cambiato laptop e mi sono accorto che lo script ha smesso di funzionare, ho quindi indagato e scoperto che senza il modulo MSOnline installato sulla vecchia versione predefinita di PowerShell (quella di Sistema), l’istruzione Import-Module MSOnline -UseWindowsPowershell non funzionerà mai (bella forza, eh?).
A questo va aggiunto che, pur installando MSOnline direttamente su PowerShell 7, questo non sarà in grado di funzionare correttamente. Lancia quindi una PowerShell di sistema come amministratore macchina ed esegui un Install-Module MSOnline dando conferma quando necessario.
Al termine dell’operazione torna su PowerShell 7 e lancia nuovamente lo script, stavolta non dovresti riscontrare alcun problema.
In caso di dubbi, lo sai già, l’area commenti è a tua totale disposizione :-)
#StaySafe
Credits: theposhwolf.com/howtos/Set-MgUserLicense-PowerShell-Assign-O365-License
Correzioni, suggerimenti? Lascia un commento nell'apposita area qui di seguito o contattami privatamente.
Ti è piaciuto l'articolo? Offrimi un caffè! ☕ :-)
L'articolo potrebbe non essere aggiornato
Questo post è stato scritto più di 5 mesi fa, potrebbe non essere aggiornato. Per qualsiasi dubbio ti invito a lasciare un commento per chiedere ulteriori informazioni! :-)
Condividi l'articolo con i tuoi contatti:
