Kaffeeundcode
Script Library
PowerShell 01.06.2026

Script Workspace

Add TeamsChannelUser

Review the purpose, inspect the code, then test it safely in your own tenant.

072_Add-TeamsChannelUser.ps1

<#
.SYNOPSIS
    Fügt einem Private Channel in Teams einen Benutzer hinzu.

.DESCRIPTION
    Private Channels haben eigene Mitgliederlisten.
    Dieses Skript fügt User hinzu.

    Parameter:
    - GroupId: Team ID
    - ChannelName: Kanal Name
    - UserEmail: User UPN
    - Role: Owner oder Member

.NOTES
    File Name: 072_Add-TeamsChannelUser.ps1
    Author: Mattia Cirillo
    Version: 1.0
#>

param (
    [Parameter(Mandatory=$true)] [string]$GroupId,
    [Parameter(Mandatory=$true)] [string]$ChannelName,
    [Parameter(Mandatory=$true)] [string]$UserEmail,
    [Parameter(Mandatory=$false)] [string]$Role = "Member"
)

try {
    Write-Host "Füge '$UserEmail' zu Channel '$ChannelName' hinzu..." -ForegroundColor Cyan

    Add-TeamChannelUser -GroupId $GroupId -DisplayName $ChannelName -User $UserEmail -Role $Role -ErrorAction Stop

    Write-Host "Benutzer hinzugefügt." -ForegroundColor Green

} catch {
    Write-Error "Fehler: $_"
}