<# .SYNOPSIS Sichert die Teams-Einstellungen (Richtlinien, Konfiguration) über das PowerShell-Modul MicrosoftTeams, nur mit Get-Cmdlets. .DESCRIPTION Meldet sich mit der App-Registrierung und dem Zertifikat an und führt alle Get-Cs*-Cmdlets des Moduls aus (ohne Sitzungs-, Voicemail- und einzelne grosse Abfragen). Je Cmdlet entsteht eine JSON-Datei, dazu ein Bericht. Schlägt die Anmeldung fehl, steht der Grund in _sign_in.json und das Skript endet ohne Fehlercode. Umgebungsvariablen: M365_CLIENT_ID, M365_TENANT_ID, M365_CERT_PATH (Zertifikat, PEM), M365_CERT_KEY_PATH (Schlüssel, PEM). .PARAMETER OutDir Zielordner, normalerweise /teams-settings. .EXAMPLE ./teams_settings.ps1 -OutDir ./backup/contoso/20261116-0557/teams-settings #> param([Parameter(Mandatory)][string]$OutDir) $ErrorActionPreference = 'Stop' foreach ($name in 'M365_CLIENT_ID', 'M365_TENANT_ID', 'M365_CERT_PATH', 'M365_CERT_KEY_PATH') { if (-not (Get-Item "env:$name" -ErrorAction SilentlyContinue)) { throw "environment variable $name is not set" } } New-Item -ItemType Directory -Force -Path $OutDir | Out-Null $cert = [System.Security.Cryptography.X509Certificates.X509Certificate2]::CreateFromPemFile($env:M365_CERT_PATH, $env:M365_CERT_KEY_PATH) $report = @{} try { Connect-MicrosoftTeams -ApplicationId $env:M365_CLIENT_ID -TenantId $env:M365_TENANT_ID -Certificate $cert | Out-Null "connected" } catch { $m = $_.Exception.Message "SIGN-IN ERROR: $m" @{ sign_in_error = $m } | ConvertTo-Json | Set-Content "$OutDir/_sign_in.json" exit 0 } $cmdlets = (Get-Command -Module MicrosoftTeams -Verb Get | Where-Object { $_.Name -like 'Get-Cs*' -and $_.Name -notmatch 'Session|Voicemail|UserPolicyPackageRecommendation|Recording|CallQueueDetails|CsOnlineUser$|SkypeFrequentlyUsed' } | ForEach-Object Name | Sort-Object -Unique) foreach ($c in $cmdlets) { try { $r = @(& $c -ErrorAction Stop) $r | ConvertTo-Json -Depth 8 -WarningAction SilentlyContinue | Set-Content "$OutDir/$($c.Substring(4)).json" $report[$c] = @{ count = $r.Count } "OK $c $($r.Count)" } catch { $m = $_.Exception.Message if ($m.Length -gt 300) { $m = $m.Substring(0, 300) } $report[$c] = @{ error = $m } "ERROR $c $m" } } $report | ConvertTo-Json -Depth 4 | Set-Content "$OutDir/_teams_report.json"