Get-M365LicenseReport.ps1

<#PSScriptInfo
.VERSION 1.0.0
.GUID 6de24d4c-affd-5852-9c45-0f88191497e2
.AUTHOR Torsten Weise
.COMPANYNAME powerscripting.de
.COPYRIGHT (c) 2026 Torsten Weise. MIT-Lizenz.
.TAGS Powerscripting German Microsoft365 M365 EntraID AzureAD Graph PSEdition_Desktop PSEdition_Core
.LICENSEURI https://powerscripting.de/skripte/files/LICENSE.txt
.PROJECTURI https://powerscripting.de/skripte/get-m365licensereport.html
.ICONURI https://powerscripting.de/assets/icon-192.png
.EXTERNALMODULEDEPENDENCIES
.REQUIREDSCRIPTS
.EXTERNALSCRIPTDEPENDENCIES
.RELEASENOTES
Erste Veröffentlichung in der PowerShell Gallery.
.PRIVATEDATA
#>


<#
.SYNOPSIS
    Zeigt, welche Microsoft-365-Lizenzen gekauft, zugewiesen und ungenutzt sind, und wo sich Kosten sparen lassen.
 
.DESCRIPTION
    Erstellt über Microsoft Graph zwei Übersichten:
      1. Pro Lizenztyp: gekauft, zugewiesen, frei und, mit Preisliste, die monatlichen Kosten der freien Lizenzen.
      2. Pro Benutzer: zugewiesene Lizenzen und Hinweise auf Sparpotenzial.
 
    Als Sparpotenzial gelten:
      - Lizenzen auf deaktivierten Konten (typisch nach Austritten)
      - Konten ohne Anmeldung seit -InactiveDays Tagen
      - Doppelbelegung, z. B. Exchange Online Plan 1 zusätzlich zu Business Standard
 
    Kryptische Produktnamen wie O365_BUSINESS_PREMIUM werden für die gängigen Lizenzen in lesbare Namen
    übersetzt. Preise kennt das Skript nicht, weil sie je nach Vertrag, Laufzeit und Händler abweichen.
    Mit -PriceFile lässt sich eine eigene Preisliste mitgeben (CSV mit den Spalten Sku;Preis, Preis pro
    Lizenz und Monat). Dann rechnet der Bericht das Sparpotenzial in Euro aus.
 
    Die letzte Anmeldung (signInActivity) liefert Graph nur mit Entra ID P1 oder höher. Ohne diese
    Lizenz entfällt die Spalte und der Hinweis auf inaktive Konten.
 
.PARAMETER InactiveDays
    Ab wie vielen Tagen ohne Anmeldung ein lizenziertes Konto als inaktiv gilt. Standard: 60.
 
.PARAMETER PriceFile
    Optional. CSV-Datei (Trennzeichen ;) mit den Spalten Sku und Preis.
 
.PARAMETER ReportPath
    Ordner für HTML- und CSV-Berichte. Standard: aktueller Ordner.
 
.EXAMPLE
    .\Get-M365LicenseReport.ps1
 
    Erstellt den Bericht ohne Preise.
 
.EXAMPLE
    .\Get-M365LicenseReport.ps1 -PriceFile .\preise.csv -InactiveDays 90
 
    Rechnet mit eigener Preisliste und gilt Konten nach 90 Tagen ohne Anmeldung als inaktiv.
    Beispiel für preise.csv:
        Sku;Preis
        O365_BUSINESS_PREMIUM;11,70
        EXCHANGESTANDARD;3,70
 
.NOTES
    Autor: Torsten Weise, powerscripting.de
    Benötigt: Install-Module Microsoft.Graph -Scope CurrentUser
    Berechtigungen: User.Read.All, Organization.Read.All, AuditLog.Read.All (für die letzte Anmeldung)
    Das Skript liest nur. Lizenzen entziehen bleibt eine bewusste Entscheidung, auch weil das
    Postfach eines Benutzers ohne Lizenz nach 30 Tagen gelöscht wird.
#>

#Requires -Modules Microsoft.Graph.Authentication, Microsoft.Graph.Identity.DirectoryManagement, Microsoft.Graph.Users
[CmdletBinding()]
param(
    [ValidateRange(7, 3650)] [int] $InactiveDays = 60,
    [string] $PriceFile,
    [string] $ReportPath = (Get-Location).Path
)

Connect-MgGraph -Scopes 'User.Read.All', 'Organization.Read.All', 'AuditLog.Read.All' -NoWelcome -ErrorAction Stop

$friendly = @{
    'O365_BUSINESS_ESSENTIALS' = 'Microsoft 365 Business Basic'
    'O365_BUSINESS_PREMIUM'    = 'Microsoft 365 Business Standard'
    'SPB'                      = 'Microsoft 365 Business Premium'
    'O365_BUSINESS'            = 'Microsoft 365 Apps for Business'
    'OFFICESUBSCRIPTION'       = 'Microsoft 365 Apps for Enterprise'
    'SPE_E3'                   = 'Microsoft 365 E3'
    'SPE_E5'                   = 'Microsoft 365 E5'
    'SPE_F1'                   = 'Microsoft 365 F3'
    'ENTERPRISEPACK'           = 'Office 365 E3'
    'ENTERPRISEPREMIUM'        = 'Office 365 E5'
    'STANDARDPACK'             = 'Office 365 E1'
    'EXCHANGESTANDARD'         = 'Exchange Online (Plan 1)'
    'EXCHANGEENTERPRISE'       = 'Exchange Online (Plan 2)'
    'EXCHANGEDESKLESS'         = 'Exchange Online Kiosk'
    'EXCHANGEARCHIVE_ADDON'    = 'Exchange Online Archivierung'
    'AAD_PREMIUM'              = 'Microsoft Entra ID P1'
    'AAD_PREMIUM_P2'           = 'Microsoft Entra ID P2'
    'EMS'                      = 'Enterprise Mobility + Security E3'
    'INTUNE_A'                 = 'Microsoft Intune Plan 1'
    'ATP_ENTERPRISE'           = 'Defender for Office 365 (Plan 1)'
    'DEFENDER_ENDPOINT_P1'     = 'Defender for Endpoint P1'
    'MCOEV'                    = 'Teams Phone Standard'
    'MCOPSTN1'                 = 'Teams Anrufplan (national)'
    'Microsoft_Teams_Rooms_Pro' = 'Teams Rooms Pro'
    'POWER_BI_PRO'             = 'Power BI Pro'
    'POWER_BI_STANDARD'        = 'Power BI (kostenlos)'
    'FLOW_FREE'                = 'Power Automate (kostenlos)'
    'TEAMS_EXPLORATORY'        = 'Teams Exploratory (kostenlos)'
    'VISIOCLIENT'              = 'Visio Plan 2'
    'PROJECTPROFESSIONAL'      = 'Project Plan 3'
    'Microsoft_365_Copilot'    = 'Microsoft 365 Copilot'
}
# Lizenzen, die eine andere voll enthalten: Benutzer mit beiden sind doppelt lizenziert
$contains = @{
    'O365_BUSINESS_PREMIUM' = 'EXCHANGESTANDARD', 'O365_BUSINESS_ESSENTIALS', 'O365_BUSINESS'
    'SPB'                   = 'EXCHANGESTANDARD', 'O365_BUSINESS_ESSENTIALS', 'O365_BUSINESS', 'O365_BUSINESS_PREMIUM', 'AAD_PREMIUM', 'INTUNE_A'
    'SPE_E3'                = 'EXCHANGESTANDARD', 'EXCHANGEENTERPRISE', 'ENTERPRISEPACK', 'OFFICESUBSCRIPTION', 'AAD_PREMIUM', 'INTUNE_A', 'EMS'
    'SPE_E5'                = 'EXCHANGESTANDARD', 'EXCHANGEENTERPRISE', 'ENTERPRISEPACK', 'ENTERPRISEPREMIUM', 'OFFICESUBSCRIPTION', 'AAD_PREMIUM', 'AAD_PREMIUM_P2', 'INTUNE_A', 'EMS', 'SPE_E3'
    'ENTERPRISEPACK'        = 'EXCHANGESTANDARD', 'EXCHANGEENTERPRISE', 'STANDARDPACK'
}

$prices = @{}
if ($PriceFile) {
    foreach ($p in (Import-Csv -Path $PriceFile -Delimiter ';')) {
        $prices[$p.Sku] = [decimal]($p.Preis -replace ',', '.')
    }
}
function Get-Name($part) { if ($friendly[$part]) { $friendly[$part] } else { $part } }
function Get-Price($part) { if ($prices.ContainsKey($part)) { $prices[$part] } else { $null } }

# Lizenztypen
$skus  = Get-MgSubscribedSku -All | Where-Object { $_.AppliesTo -eq 'User' }
$skuById = @{}
foreach ($s in $skus) { $skuById[[string]$s.SkuId] = $s.SkuPartNumber }

# Benutzer, mit letzter Anmeldung wenn möglich
$haveSignIn = $true
try {
    $users = Get-MgUser -All -Property Id, DisplayName, UserPrincipalName, AccountEnabled, AssignedLicenses, SignInActivity, CreatedDateTime -ErrorAction Stop
}
catch {
    Write-Host 'Letzte Anmeldung nicht verfügbar (meist fehlt Entra ID P1), Bericht ohne diese Spalte.' -ForegroundColor Yellow
    $haveSignIn = $false
    $users = Get-MgUser -All -Property Id, DisplayName, UserPrincipalName, AccountEnabled, AssignedLicenses, CreatedDateTime
}
$users = @($users | Where-Object { $_.AssignedLicenses.Count -gt 0 })

$now    = Get-Date
$cutoff = $now.AddDays(-$InactiveDays)
$savings = [System.Collections.Generic.List[object]]::new()

$userRows = foreach ($u in $users) {
    $parts = @($u.AssignedLicenses | ForEach-Object { $skuById[[string]$_.SkuId] } | Where-Object { $_ })
    $last  = $null
    if ($haveSignIn -and $u.SignInActivity) {
        $last = @($u.SignInActivity.LastSignInDateTime, $u.SignInActivity.LastNonInteractiveSignInDateTime) |
            Where-Object { $_ } | Sort-Object -Descending | Select-Object -First 1
    }
    $notes = [System.Collections.Generic.List[string]]::new()
    if (-not $u.AccountEnabled) {
        $notes.Add('Konto deaktiviert')
        foreach ($p in $parts) { $savings.Add([pscustomobject]@{ Benutzer = $u.UserPrincipalName; Sku = $p; Grund = 'Konto deaktiviert' }) }
    }
    elseif ($haveSignIn -and $u.CreatedDateTime -lt $cutoff -and (-not $last -or $last -lt $cutoff)) {
        $notes.Add("keine Anmeldung seit $InactiveDays Tagen")
        foreach ($p in $parts) { $savings.Add([pscustomobject]@{ Benutzer = $u.UserPrincipalName; Sku = $p; Grund = 'inaktiv' }) }
    }
    foreach ($big in $contains.Keys) {
        if ($parts -contains $big) {
            foreach ($small in ($contains[$big] | Where-Object { $parts -contains $_ })) {
                $notes.Add("$(Get-Name $small) ist in $(Get-Name $big) enthalten")
                if ($u.AccountEnabled) { $savings.Add([pscustomobject]@{ Benutzer = $u.UserPrincipalName; Sku = $small; Grund = 'doppelt' }) }
            }
        }
    }
    [pscustomobject]@{
        Name               = $u.DisplayName
        Anmeldename        = $u.UserPrincipalName
        Aktiv              = if ($u.AccountEnabled) { 'Ja' } else { 'Nein' }
        'Letzte Anmeldung' = if ($last) { ([datetime]$last).ToString('dd.MM.yyyy') } elseif ($haveSignIn) { 'nie' } else { '' }
        Lizenzen           = ($parts | ForEach-Object { Get-Name $_ }) -join ', '
        Hinweis            = $notes -join '; '
    }
}

$skuRows = foreach ($s in ($skus | Sort-Object SkuPartNumber)) {
    $total = [int]$s.PrepaidUnits.Enabled
    $used  = [int]$s.ConsumedUnits
    $free  = $total - $used
    $price = Get-Price $s.SkuPartNumber
    [pscustomobject]@{
        Lizenz        = Get-Name $s.SkuPartNumber
        Sku           = $s.SkuPartNumber
        Gekauft       = $total
        Zugewiesen    = $used
        Frei          = $free
        Status        = $s.CapabilityStatus
        'Preis/Monat' = if ($null -ne $price) { '{0:N2} €' -f $price } else { '' }
        'Frei €/Monat' = if ($null -ne $price -and $free -gt 0) { '{0:N2} €' -f ($free * $price) } else { '' }
    }
}

$skuRows | Format-Table -AutoSize
$problems = @($userRows | Where-Object Hinweis)
$problems | Format-Table Name, Aktiv, 'Letzte Anmeldung', Lizenzen, Hinweis -AutoSize

# Sparpotenzial zusammenfassen
$freeTotal = 0; $savTotal = 0
foreach ($s in $skus) { $p = Get-Price $s.SkuPartNumber; if ($null -ne $p) { $freeTotal += [math]::Max(0, $s.PrepaidUnits.Enabled - $s.ConsumedUnits) * $p } }
foreach ($x in $savings) { $p = Get-Price $x.Sku; if ($null -ne $p) { $savTotal += $p } }
$summary = "$($users.Count) lizenzierte Konten, $($problems.Count) mit Hinweis, $($savings.Count) Lizenzen mit Sparpotenzial."
if ($prices.Count) { $summary += (' Freie Lizenzen: {0:N2} €/Monat. Deaktivierte, inaktive und doppelte Zuweisungen: {1:N2} €/Monat.' -f $freeTotal, $savTotal) }
Write-Host $summary -ForegroundColor Cyan

$title = "Lizenzbericht Microsoft 365 - $($now.ToString('dd.MM.yyyy'))"
$css   = '<style>body{font-family:Segoe UI,Arial,sans-serif;font-size:13px}table{border-collapse:collapse;margin-bottom:20px}td,th{border:1px solid #ccc;padding:4px 8px}th{background:#eee}</style>'
$html  = ConvertTo-Html -Title $title -Head $css -PreContent "<h2>$title</h2><p>$summary</p>" -Body (
    ($skuRows | ConvertTo-Html -Fragment -PreContent '<h3>Lizenztypen</h3>' | Out-String) +
    ($problems | ConvertTo-Html -Fragment -PreContent '<h3>Konten mit Hinweis</h3>' | Out-String) +
    ($userRows | Sort-Object Name | ConvertTo-Html -Fragment -PreContent '<h3>Alle lizenzierten Konten</h3>' | Out-String)) | Out-String
$base = Join-Path $ReportPath ("Lizenzen_{0:yyyy-MM-dd}" -f $now)
$html | Set-Content -Path "$base.html" -Encoding UTF8
$userRows | Export-Csv -Path "$base-Benutzer.csv" -NoTypeInformation -Delimiter ';' -Encoding UTF8
$skuRows  | Export-Csv -Path "$base-Typen.csv" -NoTypeInformation -Delimiter ';' -Encoding UTF8
Write-Host "Bericht: $base.html"