mirror of
https://github.com/admindroid-community/powershell-scripts.git
synced 2025-12-17 16:35:19 +00:00
468 lines
17 KiB
PowerShell
468 lines
17 KiB
PowerShell
|
|
Param
|
|
(
|
|
[Parameter(Mandatory = $false)]
|
|
[string]$LicenseName,
|
|
[string]$LicenseUsageLocation,
|
|
[int]$Action,
|
|
[switch]$MultipleActionsMode,
|
|
[string]$UserName,
|
|
[string]$Password
|
|
)
|
|
|
|
Function Open_OutputFile
|
|
{
|
|
#Open output file after execution
|
|
if((Test-Path -Path $OutputCSVName) -eq "True")
|
|
{
|
|
if($ActionFlag -eq "Report")
|
|
{
|
|
Write-Host Detailed license report is available in: $OutputCSVName -Foregroundcolor Green
|
|
Write-Host The report has $ProcessedCount records
|
|
}
|
|
elseif($ActionFlag -eq "Mgmt")
|
|
{
|
|
Write-Host License assignment/removal log file is available in: $OutputCSVName -ForegroundColor Green
|
|
}
|
|
Write-Host `nFor more Office 365 related PowerShell scripts, check https://o365reports.com -ForegroundColor Cyan
|
|
$Prompt = New-Object -ComObject wscript.shell
|
|
$UserInput = $Prompt.popup("Do you want to open output file?",`
|
|
0,"Open Output File",4)
|
|
If ($UserInput -eq 6)
|
|
{
|
|
Invoke-Item "$OutputCSVName"
|
|
}
|
|
}
|
|
Else
|
|
{
|
|
Write-Host No records found
|
|
}
|
|
Write-Progress -Activity Export CSV -Completed
|
|
}
|
|
|
|
#Get users' details
|
|
Function Get_UserInfo
|
|
{
|
|
$global:DisplayName=$_.DisplayName
|
|
$global:UPN=$_.UserPrincipalName
|
|
$global:Licenses=$_.Licenses.AccountSkuId
|
|
$SigninStatus=$_.BlockCredential
|
|
if($SigninStatus -eq $False)
|
|
{$global:SigninStatus="Enabled"}
|
|
else{$global:SigninStatus="Disabled"}
|
|
$global:Department=$_.Department
|
|
$global:JobTitle=$_.Title
|
|
if($Department -eq $null)
|
|
{$global:Department="-"}
|
|
if($JobTitle -eq $null)
|
|
{$global:JobTitle="-"}
|
|
}
|
|
|
|
Function Get_License_FriendlyName
|
|
{
|
|
$FriendlyName=@()
|
|
$LicensePlan=@()
|
|
#Convert license plan to friendly name
|
|
foreach($License in $Licenses)
|
|
{
|
|
$LicenseItem= $License -Split ":" | Select-Object -Last 1
|
|
$EasyName=$FriendlyNameHash[$LicenseItem]
|
|
if(!($EasyName))
|
|
{$NamePrint=$LicenseItem}
|
|
else
|
|
{$NamePrint=$EasyName}
|
|
$FriendlyName=$FriendlyName+$NamePrint
|
|
$LicensePlan=$LicensePlan+$LicenseItem
|
|
}
|
|
$global:LicensePlans=$LicensePlan -join ","
|
|
$global:FriendlyNames=$FriendlyName -join ","
|
|
}
|
|
|
|
Function Set_UsageLocation
|
|
{
|
|
if($LicenseUsageLocation -ne "")
|
|
{
|
|
"Assigning Usage Location $LicenseUsageLocation to $UserName" | Out-File $OutputCSVName -Append
|
|
Set-MsolUser -UserPrincipalName $UserName -UsageLocation $LicenseUsageLocation
|
|
}
|
|
else
|
|
{
|
|
"Usage location is mandatory to assign license. Please set Usage location for $UserName" | Out-File $OutputCSVName -Append
|
|
}
|
|
}
|
|
|
|
Function Assign_Licenses
|
|
{
|
|
"Assigning $LicenseNames license to $UPN" | Out-File $OutputCSVName -Append
|
|
Set-MsolUserLicense -UserPrincipalName $UPN -AddLicenses $LicenseNames
|
|
if($?)
|
|
{
|
|
"License assigned successfully" | Out-File $OutputCSVName -Append
|
|
}
|
|
else
|
|
{
|
|
"License assignment failed" | Out-file $OutputCSVName -Append
|
|
}
|
|
}
|
|
|
|
Function Remove_Licenses
|
|
{
|
|
Write-Progress -Activity "`n Removing $License license from $UPN "`n" Processed users: $ProcessedCount"
|
|
"Removing $License license from $UPN" | Out-File $OutputCSVName -Append
|
|
Set-MsolUserLicense -UserPrincipalName $UPN -RemoveLicenses $License
|
|
if($?)
|
|
{
|
|
"License removed successfully" | Out-File $OutputCSVName -Append
|
|
}
|
|
else
|
|
{
|
|
"License removal failed" | Out-file $OutputCSVName -Append
|
|
}
|
|
}
|
|
|
|
Function main()
|
|
{
|
|
#Check for MSOnline module
|
|
$Modules=Get-Module -Name MSOnline -ListAvailable
|
|
if($Modules.count -eq 0)
|
|
{
|
|
Write-Host Please install MSOnline module using below command: `nInstall-Module MSOnline -ForegroundColor yellow
|
|
Exit
|
|
}
|
|
|
|
#Storing credential in script for scheduling purpose/ Passing credential as parameter
|
|
if(($UserName -ne "") -and ($Password -ne ""))
|
|
{
|
|
$SecuredPassword = ConvertTo-SecureString -AsPlainText $Password -Force
|
|
$Credential = New-Object System.Management.Automation.PSCredential $UserName,$SecuredPassword
|
|
Connect-MsolService -Credential $credential
|
|
}
|
|
else
|
|
{
|
|
Connect-MsolService | Out-Null
|
|
}
|
|
$Result=""
|
|
$Results=@()
|
|
$FriendlyNameHash=Get-Content -Raw -Path .\LicenseFriendlyName.txt -ErrorAction Stop | ConvertFrom-StringData
|
|
[boolean]$Delay=$false
|
|
|
|
|
|
Do {
|
|
if($Action -eq "")
|
|
{
|
|
|
|
|
|
Write-Host ""
|
|
Write-host `nOffice 365 License Reporting -ForegroundColor Yellow
|
|
Write-Host " 1.Get all licensed users" -ForegroundColor Cyan
|
|
Write-Host " 2.Get all unlicensed users" -ForegroundColor Cyan
|
|
Write-Host " 3.Get users with specific license type" -ForegroundColor Cyan
|
|
Write-Host " 4.Get all disabled users with licenses" -ForegroundColor Cyan
|
|
Write-Host " 5.Office 365 license usage report" -ForegroundColor Cyan
|
|
Write-Host `nOffice 365 License Management -ForegroundColor Yellow
|
|
Write-Host " 6.Bulk:Assign a license to users (input CSV)" -ForegroundColor Cyan
|
|
Write-Host " 7.Bulk:Assign multiple licenses to users (input CSV)" -ForegroundColor Cyan
|
|
Write-Host " 8.Remove all license from a user" -ForegroundColor Cyan
|
|
Write-Host " 9.Bulk:Remove all licenses from users (input CSV)" -ForegroundColor Cyan
|
|
Write-Host " 10.Remove specific license from all users" -ForegroundColor Cyan
|
|
Write-Host " 11.Remove all license from disabled users" -ForegroundColor Cyan
|
|
Write-Host " 0.Exit" -ForegroundColor Cyan
|
|
Write-Host ""
|
|
$GetAction = Read-Host 'Please choose the action to continue'
|
|
}
|
|
else
|
|
{
|
|
$GetAction=$Action
|
|
}
|
|
|
|
Switch ($GetAction) {
|
|
1 {
|
|
$OutputCSVName=".\O365UserLicenseReport_$((Get-Date -format yyyy-MMM-dd-ddd` hh-mm` tt).ToString()).csv"
|
|
Write-Host Generating licensed users report...
|
|
$ProcessedCount=0
|
|
Get-MsolUser -All | where {$_.IsLicensed -eq $true} | foreach {
|
|
$ProcessedCount++
|
|
Get_UserInfo
|
|
Write-Progress -Activity "`n Processed users count: $ProcessedCount "`n" Currently Processing: $DisplayName"
|
|
Get_License_FriendlyName
|
|
$Result = @{'Display Name'=$Displayname;'UPN'=$upn;'License Plan'=$LicensePlans;'License Plan Friendly Name'=$FriendlyNames;'Account Status'=$SigninStatus;'Department'=$Department;'Job Title'=$JobTitle }
|
|
$Results = New-Object PSObject -Property $Result
|
|
$Results |select-object 'Display Name','UPN','License Plan','License Plan Friendly Name','Account Status','Department','Job Title' | Export-Csv -Path $OutputCSVName -Notype -Append
|
|
}
|
|
$ActionFlag="Report"
|
|
Open_OutputFile
|
|
}
|
|
|
|
2 {
|
|
$OutputCSVName=".\O365UnlicenedUserReport_$((Get-Date -format yyyy-MMM-dd-ddd` hh-mm` tt).ToString()).csv"
|
|
Write-Host Generating Unlicensed users report...
|
|
$ProcessedCount=0
|
|
Get-MsolUser -All -UnlicensedUsersOnly | foreach {
|
|
$ProcessedCount++
|
|
Get_UserInfo
|
|
Write-Progress -Activity "`n Processed users count: $ProcessedCount "`n" Currently Processing: $DisplayName"
|
|
$Result = @{'Display Name'=$Displayname;'UPN'=$UPN;'Department'=$Department;'Signin Status'=$SigninStatus;'Job Title'=$JobTitle }
|
|
$Results = New-Object PSObject -Property $Result
|
|
$Results |select-object 'Display Name','UPN','Department','Job Title','Signin Status' | Export-Csv -Path $OutputCSVName -Notype -Append
|
|
}
|
|
$ActionFlag="Report"
|
|
Open_OutputFile
|
|
}
|
|
|
|
3 {
|
|
$OutputCSVName="./O365UsersWithSpecificLicenseReport__$((Get-Date -format yyyy-MMM-dd-ddd` hh-mm` tt).ToString()).csv"
|
|
if($LicenseName -eq "")
|
|
{
|
|
$LicenseName=Read-Host "Enter the license SKU(Eg:contoso:Enterprisepack)"
|
|
}
|
|
Write-Host Getting users with $LicenseName license...
|
|
$ProcessedCount=0
|
|
if((Get-MsolAccountSku).AccountSkuID -icontains $LicenseName)
|
|
{
|
|
Get-MsolUser -All | Where-Object {($_.licenses).AccountSkuId -eq $LicenseName} | foreach{
|
|
$ProcessedCount++
|
|
Get_UserInfo
|
|
Write-Progress -Activity "`n Processed users count: $ProcessedCount "`n" Currently Processing: $DisplayName"
|
|
Get_License_FriendlyName
|
|
$Result = @{'Display Name'=$Displayname;'UPN'=$upn;'License Plan'=$LicensePlans;'License Plan_Friendly Name'=$FriendlyNames;'Account Status'=$SigninStatus;'Department'=$Department;'Job Title'=$JobTitle }
|
|
$Results = New-Object PSObject -Property $Result
|
|
$Results |select-object 'Display Name','UPN','License Plan','License Plan_Friendly Name','Account Status','Department','Job Title' | Export-Csv -Path $OutputCSVName -Notype -Append
|
|
}
|
|
}
|
|
else
|
|
{
|
|
Write-Host $LicenseName is not used in your organization. Please check the license name or run the License Usage Report to know the licenses in your org -ForegroundColor Red
|
|
}
|
|
#Clearing license name for next iteration
|
|
$LicenseName=""
|
|
$ActionFlag="Report"
|
|
Open_OutputFile
|
|
}
|
|
|
|
4 {
|
|
$OutputCSVName="./O365DiabledUsersWithLicense__$((Get-Date -format yyyy-MMM-dd-ddd` hh-mm` tt).ToString()).csv"
|
|
$ProcessedCount=0
|
|
Write-Host Finding disabled users still licensed in Office 365...
|
|
Get-MsolUser -All -EnabledFilter DisabledOnly | where {$_.IsLicensed -eq $true} | foreach {
|
|
$ProcessedCount++
|
|
Get_UserInfo
|
|
Write-Progress -Activity "`n Processed users count: $ProcessedCount "`n" Currently Processing: $DisplayName"
|
|
$AssignedLicense=""
|
|
$FriendlyName=""
|
|
$Count=0
|
|
Get_License_FriendlyName
|
|
$Result = @{'Display Name'=$Displayname;'UPN'=$upn;'License Plan'=$LicensePlans;'License Plan_Friendly Name'=$FriendlyNames;'Department'=$Department;'Job Title'=$JobTitle }
|
|
$Results = New-Object PSObject -Property $Result
|
|
$Results |select-object 'Display Name','UPN','License Plan','License Plan_Friendly Name','Department','Job Title' | Export-Csv -Path $OutputCSVName -Notype -Append
|
|
}
|
|
$ActionFlag="Report"
|
|
Open_OutputFile
|
|
}
|
|
|
|
5 {
|
|
$OutputCSVName="./Office365LicenseUsageReport__$((Get-Date -format yyyy-MMM-dd-ddd` hh-mm` tt).ToString()).csv"
|
|
Write-Host Generating Office 365 license usage report...
|
|
$ProcessedCount=0
|
|
Get-MsolAccountSku | foreach {
|
|
$ProcessedCount++
|
|
$AccountSkuID=$_.AccountSkuID
|
|
$LicensePlan= $_.SkuPartNumber
|
|
$SubscriptionState=Get-MsolSubscription
|
|
Write-Progress -Activity "`n Retrieving license info "`n" Currently Processing: $LicensePlan"
|
|
$EasyName=$FriendlyNameHash[$LicensePlan]
|
|
if(!($EasyName))
|
|
{$FriendlyName=$LicenseItem}
|
|
else
|
|
{$FriendlyName=$EasyName}
|
|
$Result = @{'AccountSkuId'=$AccountSkuID;'License Plan_Friendly Name'=$FriendlyName;'Active Units'=$_.ActiveUnits;'Consumed Units'=$_.ConsumedUnits }
|
|
$Results = New-Object PSObject -Property $Result
|
|
$Results |select-object 'AccountSkuId','License Plan_Friendly Name','Active Units','Consumed Units' | Export-Csv -Path $OutputCSVName -Notype -Append
|
|
}
|
|
$ActionFlag="Report"
|
|
Open_OutputFile
|
|
}
|
|
|
|
6 {
|
|
$OutputCSVName="./Office365LicenseAssignment_Log__$((Get-Date -format yyyy-MMM-dd-ddd` hh-mm` tt).ToString()).txt"
|
|
$UserNamesFile=Read-Host "Enter the CSV file containing user names(Eg:D:/UserNames.csv)"
|
|
|
|
#We have an input file, read it into memory
|
|
$UserNames=@()
|
|
$UserNames=Import-Csv -Header "UPN" $UserNamesFile
|
|
$ProcessedCount=0
|
|
$LicenseNames=Read-Host "Enter the license name(Eg:contoso:Enterprisepack)"
|
|
Write-Host Assigning license to users...
|
|
if((Get-MsolAccountSku).AccountSkuID -icontains $LicenseNames)
|
|
{
|
|
foreach($Item in $UserNames)
|
|
{
|
|
$ProcessedCount++
|
|
$UPN=$Item.UPN
|
|
Write-Progress -Activity "`n Assigning $LicenseNames license to $UPN "`n" Processed users: $ProcessedCount"
|
|
$UsageLocation=(Get-MsolUser -UserPrincipalName $UPN).UsageLocation
|
|
if($UsageLocation -eq $null)
|
|
{
|
|
Set_UsageLocation
|
|
}
|
|
else
|
|
{
|
|
Assign_Licenses
|
|
}
|
|
}
|
|
}
|
|
else
|
|
{
|
|
Write-Host $LicenseNames is not used in your organization. Please check the license name or run the License Usage Report to know the licenses in your org -ForegroundColor Red
|
|
}
|
|
#Clearing license name and input file location for next iteration
|
|
$LicenseNames=""
|
|
$UserNamesFile=""
|
|
$ActionFlag="Mgmt"
|
|
Open_OutputFile
|
|
}
|
|
|
|
7 {
|
|
$OutputCSVName="./Office365LicenseAssignment_Log__$((Get-Date -format yyyy-MMM-dd-ddd` hh-mm` tt).ToString()).txt"
|
|
$UserNamesFile=Read-Host "Enter the CSV file containing user names(Eg:D:/UserNames.csv)"
|
|
|
|
#We have an input file, read it into memory
|
|
$UserNames=@()
|
|
$UserNames=Import-Csv -Header "UPN" $UserNamesFile
|
|
$Flag=""
|
|
$ProcessedCount=0
|
|
$LicenseNames=Read-Host "Enter the license names(Eg:TenantName:LicensePlan1,TenantName:LicensePlan2)"
|
|
$LicenseNames=$LicenseNames.Replace(' ','')
|
|
$LicenseNames=$LicenseNames.split(",")
|
|
foreach($LicenseName in $LicenseNames)
|
|
{
|
|
if((Get-MsolAccountSku).AccountSkuID -inotcontains $LicenseName)
|
|
{
|
|
$Flag="Terminate"
|
|
Write-Host $LicenseName is not used in your organization. Please check the license name or run the License Usage Report to know the licenses in your org -ForegroundColor Red
|
|
}
|
|
}
|
|
if($Flag -eq "Terminate")
|
|
{
|
|
Write-Host Please re-run the script with appropriate license name -ForegroundColor Yellow
|
|
}
|
|
else
|
|
{
|
|
Write-Host Assigning licenses to Office 365 users...
|
|
foreach($Item in $UserNames)
|
|
{
|
|
$UPN=$Item.UPN
|
|
$ProcessedCount++
|
|
$UsageLocation=(Get-MsolUser -UserPrincipalName $UPN).UsageLocation
|
|
if($UsageLocation -eq $null)
|
|
{
|
|
Set_UsageLocation
|
|
}
|
|
else
|
|
{
|
|
Write-Progress -Activity "`n Assigning licenses to $UPN "`n" Processed users: $ProcessedCount"
|
|
Assign_Licenses
|
|
}
|
|
}
|
|
}
|
|
#Clearing license names and input file location for next iteration
|
|
$LicenseNames=""
|
|
$UserNamesFile=""
|
|
$ActionFlag="Mgmt"
|
|
Open_OutputFile
|
|
}
|
|
|
|
|
|
8 {
|
|
$Identity=Read-Host Enter User UPN
|
|
$UserInfo=Get-MsolUser -UserPrincipalName $Identity
|
|
#Checking whether the user is available
|
|
if($UserInfo -eq $null)
|
|
{
|
|
Write-Host User $Identity does not exist. Please check the user name. -ForegroundColor Red
|
|
}
|
|
else
|
|
{
|
|
$Licenses=$UserInfo.Licenses.AccountSkuID
|
|
Write-Host Removing $Licenses license from $Identity
|
|
Set-MsolUserLicense -UserPrincipalName $Identity -RemoveLicenses $Licenses
|
|
Write-Host Action completed -ForegroundColor Green
|
|
}
|
|
}
|
|
|
|
9 {
|
|
$OutputCSVName="./Office365LicenseRemoval_Log__$((Get-Date -format yyyy-MMM-dd-ddd` hh-mm` tt).ToString()).txt"
|
|
$UserNamesFile=Read-Host "Enter the CSV file containing user names(Eg:D:/UserNames.csv)"
|
|
|
|
#We have an input file, read it into memory
|
|
$UserNames=@()
|
|
$UserNames=Import-Csv -Header "UPN" $UserNamesFile
|
|
$ProcessedCount=0
|
|
foreach($Item in $UserNames)
|
|
{
|
|
$UPN=$Item.UPN
|
|
$ProcessedCount++
|
|
# Write-Progress -Activity "`n Removing license from $UPN "`n" Processed users: $ProcessedCount"
|
|
$License=(Get-MsolUser -UserPrincipalName $UPN).licenses.AccountSkuID
|
|
Remove_Licenses
|
|
}
|
|
$ActionFlag="Mgmt"
|
|
Open_OutputFile
|
|
}
|
|
|
|
10 {
|
|
$OutputCSVName="./O365LicenseRemoval_Log__$((Get-Date -format yyyy-MMM-dd-ddd` hh-mm` tt).ToString()).txt"
|
|
$License=Read-Host "Enter the license name(Eg:TenantName:LicensePlan)"
|
|
$ProcessedCount=0
|
|
Write-Host Removing $License license from users...
|
|
if((Get-MsolAccountSku).AccountSkuID -icontains $License)
|
|
{
|
|
Get-MsolUser -All | Where-Object {($_.licenses).AccountSkuId -eq $License} | foreach{
|
|
$ProcessedCount++
|
|
$UPN=$_.UserPrincipalName
|
|
Remove_Licenses
|
|
}
|
|
}
|
|
else
|
|
{
|
|
Write-Host $License not used in your organization. Please check the license name or run the License Usage Report to know the licenses in your org -ForegroundColor Red
|
|
}
|
|
$ActionFlag="Mgmt"
|
|
Open_OutputFile
|
|
}
|
|
|
|
11 {
|
|
$OutputCSVName="./O365LicenseRemoval_Log__$((Get-Date -format yyyy-MMM-dd-ddd` hh-mm` tt).ToString()).txt"
|
|
Write-Host Removing license from disabled users...
|
|
$ProcessedCount=0
|
|
Get-MsolUser -All -EnabledFilter DisabledOnly | where {$_.IsLicensed -eq $true} | foreach {
|
|
$ProcessedCount++
|
|
$UPN=$_.UserPrincipalName
|
|
$License=$_.Licenses.AccountSkuID
|
|
Remove_Licenses
|
|
}
|
|
$ActionFlag="Mgmt"
|
|
Open_OutputFile
|
|
}
|
|
}
|
|
if($Action -ne "")
|
|
{exit}
|
|
if($MultipleActionsMode.ispresent)
|
|
{
|
|
Start-Sleep -Seconds 2
|
|
}
|
|
else
|
|
{
|
|
Exit
|
|
}
|
|
}
|
|
While ($GetAction -ne 0)
|
|
Clear-Host
|
|
}
|
|
. main
|
|
|
|
<#
|
|
=============================================================================================
|
|
Name: Office 365 license reporting and management using PowerShell
|
|
For detailed Script execution: https://o365reports.com/2021/11/23/office-365-license-reporting-and-management-using-powershell
|
|
============================================================================================
|
|
#> |