È un argomento già discusso e sul quale sono già tornato ma che rimane interessante e “comodo da disturbare” in caso di necessità vista la velocità delle API Graph e la loro capacità di andare sempre molto nello specifico dell’esigenza. Il caso d’uso riguarda la rimozione di un singolo piano di una licenza (due) ben specifica di Microsoft 365, più precisamente sto parlando del piano legato a Skype for Business e la licenza di riferimento è la Microsoft 365 Business Standard (e la stessa cosa succede nella Microsoft 365 Business Premium).

In parte è prendere ciò che era stato fatto e riportato nell’articolo Licenze Microsoft 365: modifica bulk via PowerShell 7 e Graph ma con una piccola differenza: nel precedente caso mi serviva cambiare completamente licenza assegnata a un gruppo di utenti e – contestualmente – disattivare proprio il piano relativo a Skype for Business in un solo colpo. Qui si tratta di lasciare tutto invariato rispetto alla situazione che si incontra, ma andare a rimuovere il solo piano Skype for Business che è stato reso disponibile anche sulle licenze Microsoft 365 Business (Standard / Premium), vanificando così la disattivazione dello stesso piano sulle licenze di altro tipo.

Il ragionamento (e lo script) è adattabile a qualsiasi altro piano esistente, va da sé e non ci dovrebbe neanche essere necessità di dirlo.

Connettiti a Microsoft Graph. Se non sai come farlo, sbircia uno dei miei precedenti articoli.

Cerca (e rimuovi)

Ho voluto spezzare il processo in due.
Una prima parte si occuperà di cercare i piani attivi in mezzo alle licenze di tutti gli utenti del tenant a prescindere da quelle che essi hanno associate. Se un particolare piano è attivo io voglio sapere di quale si tratta nello specifico e da quale licenza proviene.

findSkypeActivePlans.ps1 si occuperà di fare la ricerca e salvare il risultato della medesima all’interno di un file CSV che verrà creato all’interno della cartella attiva di PowerShell, removeSkypeActivePlans.ps1 prenderà quel file CSV (che tu passerai da riga di comando) e andrà a rimuovere il piano desiderato e precedentemente individuato. Ho pubblicato entrambi gli script su Gist:

Quello che ho fatto è stato prendere in esame la solita documentazione Microsoft con tutte le corrispondenze tra nomi licenze / piani e relativo GUID (go.gioxx.org/m365-licenseguid), individuare quelli relativi a Skype for Business (afc06cb0-b4f4-4473-8286-d644f70d8faf, b2669e95-76ef-4e7e-a367-002f60a39f3e, 0feaeb32-d00e-4d66-bd5a-43b5b83db82c, 70710b6b-3ab4-4a38-9f6d-9f169461650a) e darli in pasto al ciclo di controllo.

Se anche solo uno di quei GUID vengono rilevati all’interno del più nutrito gruppo di GUID composto dai vari piani associati a una determinata licenza, ecco che allora raccolgo il risultato in un vettore portandomi dietro tra le altre cose anche il nome dell’utente, il suo indirizzo di posta elettronica, lo SkuId della licenza che contiene il piano “incriminato” e l’ID preciso del piano individuato. Questi due ultimi dati sono fondamentali per poter effettuare successivamente la rimozione del piano dalla licenza.

Rimozione sì, ma con “Add“

Tranquillo, non ho bevuto, non ancora almeno.
Lo script di rimozione del piano (removeSkypeActivePlans.ps1) necessita di un solo parametro obbligatorio: il file CSV precedentemente prodotto dallo script di ricerca (findSkypeActivePlans.ps1) e dovrai passarglielo tu tramite riga di comando (usalo come primo parametro direttamente, altrimenti ti verrà richiesto comunque a video nel momento in cui lancerai lo script senza).

A quel punto inizierà a lanciare la disattivazione del piano andandolo a “spegnere” all’interno della licenza che lo contiene. Per farlo avevo stupidamente pensato che avrei dovuto effettuare un’operazione di Set-MgUserLicense con parametro RemoveLicenses, ma in realtà sbagliavo, perché avrei causato la rimozione completa della licenza padre (che contiene il piano “indesiderato“), ho quindi modificato lo script affinché non rimuova alcunché ma vada ad “aggiungere” la medesima licenza ma con un piano in meno, ed ecco spiegato il perché dell’istruzione finale Set-MgUserLicense -UserId $User.UserPrincipalName -RemoveLicenses @() -AddLicenses $skypePlanToRemove

Ho salvato entrambi gli script anche in un nuovo repository dedicato allo scripting che va oltre il modulo ToyBox che sto continuando a mantenere (abbandonando così la vecchia scuola degli script singoli, anche se devo decidermi a documentarlo completamente), mi servirà a mantenerli aggiornati più comodamente: github.com/gioxx/m365-tools/tree/main/removeSkypeActivePlans.

In caso di dubbi sai già cosa fare, l’area commenti è a tua totale disposizione :-)

#KeepItSimple