Created
September 15, 2023 13:15
-
-
Save gioxx/794829bb65652a76cd5b223bad8242c6 to your computer and use it in GitHub Desktop.
Cercare e rimuovere piani attivi di Skype for Business per tutti gli utenti del tenant Microsoft 365: come farlo con due script. | Search and remove active Skype for Business plans for all Microsoft 365 tenant users: how to do it with two scripts. | Vedi articolo sul blog: https://wp.me/pdQ5q-u6Y
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| <# | |
| .SYNOPSIS | |
| Find active Skype for Business services on the entire tenant using Microsoft Graph. | |
| .DESCRIPTION | |
| Find active Skype for Business services on the entire tenant using Microsoft Graph. Generates an array containing the detected user and license and displays it on the screen. | |
| It also saves the same data in a CSV file within the folder from which you are launching the script (Current Directory in PowerShell) that can be used for later manipulation of users and licenses (and active Skype for Business plans). | |
| You can execute this script without parameters and wait for results. | |
| .NOTES | |
| Filename: findSkypeActivePlans.ps1 | |
| Version: 0.1, 2023 | |
| Author: GSolone | |
| Blog: gioxx.org | |
| Twitter: @gioxx | |
| Changes: | |
| 13/9/23- Change: I take out currentSkuId and UserPrincipalName which are needed later to "feed" the Remove script. | |
| 8/9/23- First version of the script. | |
| .COMPONENT | |
| - | |
| .LINK | |
| https://learn.microsoft.com/en-us/powershell/module/microsoft.graph.identity.directorymanagement/get-mgsubscribedsku?view=graph-powershell-1.0 | |
| https://learn.microsoft.com/it-it/microsoft-365/enterprise/view-licenses-and-services-with-microsoft-365-powershell?view=o365-worldwide | |
| https://learn.microsoft.com/it-it/azure/active-directory/enterprise-users/licensing-service-plan-reference#service-skype-for-business | |
| https://learn.microsoft.com/en-us/powershell/module/microsoft.graph.users/get-mguserlicensedetail?view=graph-powershell-1.0 | |
| https://learn.microsoft.com/en-us/microsoft-365/enterprise/disable-access-to-services-with-microsoft-365-powershell?view=o365-worldwide | |
| #> | |
| function priv_SaveFileWithProgressiveNumber($path) { | |
| $baseName = [System.IO.Path]::GetFileNameWithoutExtension($path) | |
| $extension = [System.IO.Path]::GetExtension($path) | |
| $directory = [System.IO.Path]::GetDirectoryName($path) | |
| $count = 1 | |
| while (Test-Path $path) | |
| { | |
| $fileName = $baseName + "_$count" + $extension | |
| $path = Join-Path -Path $directory -ChildPath $fileName | |
| $count++ | |
| } | |
| return $path | |
| } | |
| Set-Variable ProgressPreference Continue | |
| $Result = @() | |
| $ProcessedCount = 0 | |
| # Check https://learn.microsoft.com/it-it/azure/active-directory/enterprise-users/licensing-service-plan-reference#service-skype-for-business | |
| $skypePlans = @( | |
| "afc06cb0-b4f4-4473-8286-d644f70d8faf", | |
| "b2669e95-76ef-4e7e-a367-002f60a39f3e", | |
| "0feaeb32-d00e-4d66-bd5a-43b5b83db82c", | |
| "70710b6b-3ab4-4a38-9f6d-9f169461650a" | |
| ) | |
| $skypePlansActive = 0 | |
| $skypePlansActiveUsers = @() | |
| $Users = Get-MgUser -Filter 'assignedLicenses/$count ne 0' -ConsistencyLevel eventual -CountVariable totalUsers -All | |
| $Users | ForEach { | |
| $ProcessedCount++ | |
| $PercentComplete = (($ProcessedCount / $totalUsers) * 100) | |
| $User = $_ | |
| Write-Progress -Activity "Processing $($User.DisplayName)" -Status "$ProcessedCount out of $totalUsers ($($PercentComplete.ToString('0.00'))%)" -PercentComplete $PercentComplete | |
| $GraphLicense = Get-MgUserLicenseDetail -UserId $User.Id | |
| if ( $GraphLicense -ne $null ) { | |
| ForEach ( $License in $($GraphLicense.SkuPartNumber) ) { | |
| $currentSkuId = $GraphLicense | ? { $_.SkuPartNumber -eq $license } | select -ExpandProperty SkuId | |
| $servicePlans = $GraphLicense | ? { $_.SkuPartNumber -eq $license } | select -ExpandProperty ServicePlans | |
| $mcoStatus = $servicePlans | ? { $_.ServicePlanId -in $skypePlans } | |
| if ( $mcoStatus -ne $null -and $mcoStatus.ProvisioningStatus -eq "Success" ) { | |
| $skypePlansActive++ | |
| $skypePlansActiveUsers += New-Object -TypeName PSObject -Property $([ordered]@{ | |
| DisplayName = $User.DisplayName | |
| UserPrincipalName = $User.UserPrincipalName | |
| SMTPAddress = $User.Mail | |
| SkuId = $currentSkuId | |
| SkypePlan = $mcoStatus.ProvisioningStatus | |
| SkypePlanName = $mcoStatus.ServicePlanName | |
| SkypePlanId = $mcoStatus.ServicePlanId | |
| }) | |
| break | |
| } | |
| } | |
| } | |
| } | |
| if ( $skypePlansActive -gt 0 ) { | |
| $CSV = priv_SaveFileWithProgressiveNumber("$($PWD)\$((Get-Date -format "yyyyMMdd").ToString())_M365-Skype-Active-Users.csv") | |
| Write-Host "`nSkype Active Plans found: $skypePlansActive`nAlso saved as $CSV" -f "Yellow" | |
| $skypePlansActiveUsers | Select DisplayName, SMTPAddress, SkypePlanName | Out-Host | |
| $skypePlansActiveUsers | Export-CSV $CSV -NoTypeInformation -Encoding UTF8 -Delimiter ";" | |
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| <# | |
| .SYNOPSIS | |
| Remove active Skype for Business services on the entire tenant using Microsoft Graph and a CSV file. | |
| .DESCRIPTION | |
| Remove active Skype for Business services on the entire tenant using Microsoft Graph (require findSkypeActivePlans.ps1 script). | |
| You can run this script by passing the parameter for the CSV file to be used to remove the Skype plan found active. | |
| .NOTES | |
| Filename: removeSkypeActivePlans.ps1 | |
| Version: 0.1, 2023 | |
| Author: GSolone | |
| Blog: gioxx.org | |
| Twitter: @gioxx | |
| Changes: | |
| 13/9/23- First version of the script. | |
| .COMPONENT | |
| - | |
| .LINK | |
| https://learn.microsoft.com/en-us/powershell/module/microsoft.graph.identity.directorymanagement/get-mgsubscribedsku?view=graph-powershell-1.0 | |
| https://learn.microsoft.com/it-it/microsoft-365/enterprise/view-licenses-and-services-with-microsoft-365-powershell?view=o365-worldwide | |
| https://learn.microsoft.com/it-it/azure/active-directory/enterprise-users/licensing-service-plan-reference#service-skype-for-business | |
| https://learn.microsoft.com/en-us/powershell/module/microsoft.graph.users/get-mguserlicensedetail?view=graph-powershell-1.0 | |
| https://learn.microsoft.com/en-us/microsoft-365/enterprise/disable-access-to-services-with-microsoft-365-powershell?view=o365-worldwide | |
| #> | |
| Param( | |
| [Parameter(Position=0, Mandatory=$true, ValueFromPipeline=$true, HelpMessage="CSV file to use (e.g. C:\Temp\20230908_M365-Skype-Active-Users.csv)")] | |
| [string] $CSV | |
| ) | |
| Set-Variable ProgressPreference Continue | |
| $ProcessedCount = 0 | |
| $totalUsers = Import-Csv $CSV -Delimiter ";" | Measure-Object | Select-Object -ExpandProperty count | |
| Write-Host "Rows: $($totalUsers)" -f "Yellow" | |
| Import-Csv $CSV -Delimiter ";" | ForEach { | |
| $ProcessedCount++ | |
| $PercentComplete = (($ProcessedCount / $totalUsers) * 100) | |
| $User = $_ | |
| Write-Progress -Activity "Processing $($User.DisplayName) ($($User.SkypePlanName))" -Status "$ProcessedCount out of $totalUsers ($($PercentComplete.ToString('0.00'))%)" -PercentComplete $PercentComplete | |
| $skypePlanToRemove = @( | |
| @{ | |
| SkuId = $($User.SkuId) | |
| DisabledPlans = $($User.SkypePlanId) | |
| } | |
| ) | |
| Set-MgUserLicense -UserId $User.UserPrincipalName -RemoveLicenses @() -AddLicenses $skypePlanToRemove | Out-Null | |
| } |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment