Website-Suche

Massenmäßiges Hinzufügen von Benutzern zu Microsoft Teams mithilfe von PowerShell

Anforderung: Massenmäßiges Hinzufügen von Benutzern zu Microsoft Teams aus einer CSV-Datei.

Wie füge ich mehrere Benutzer in großen Mengen zu Microsoft Teams hinzu?

Microsoft Teams bietet eine großartige Möglichkeit, mit Kollegen und Mitarbeitern zu kommunizieren. Über die Teams-App können Sie Benutzer ganz einfach manuell einzeln zu Ihrem Team hinzufügen. Was aber, wenn Sie eine große Anzahl von Benutzern hinzufügen müssen? In Microsoft Teams ist das Massenhinzufügen von Mitgliedern beim Erstellen eines neuen Teams nicht möglich.

Die gute Nachricht ist, dass wir PowerShell dafür nutzen können! Das Hinzufügen von Massenbenutzern zu Ihrem Microsoft Teams-Konto kann ein zeitaufwändiger Prozess sein, insbesondere wenn Sie viele neue Mitarbeiter hinzufügen müssen. In diesem Artikel erfahren Sie, wie Sie Massenbenutzer in Microsoft Teams hinzufügen. Das Hinzufügen oder Entfernen von Mitgliedern/Eigentümern zu Microsoft Teams kann mit PowerShell erfolgen, wie in meinem anderen Beitrag: Verwalten von Microsoft Teams mit PowerShell; Dieser Beitrag zielt darauf ab, Benutzer in großen Mengen hinzuzufügen.

Ich gehe davon aus, dass das Microsoft Teams PowerShell-Modul bereits auf Ihrem Computer installiert ist. Wenn nicht, installieren Sie es: Wie installiere ich das PowerShell-Modul für Microsoft Teams?

Das Hinzufügen von Benutzern zu Microsoft Teams umfasst vier Schritte:

  1. Stellen Sie über PowerShell eine Verbindung zu Microsoft Teams her
  2. Ermitteln Sie die Gruppen-ID des Teams, dem Sie Benutzer hinzufügen möchten.
  3. Füllen Sie eine CSV-Datei mit der Liste aller Benutzer, die Sie dem Team hinzufügen möchten
  4. Verwenden Sie das PowerShell-Skript, um die CSV-Datei zu lesen und Mitglieder zum Team hinzuzufügen.

Schritt 1: Stellen Sie über PowerShell eine Verbindung zu Microsoft Teams her

Zunächst müssen wir über PowerShell eine Verbindung zu Microsoft Teams herstellen. Verwenden Sie das Cmdlet Connect-MicrosoftTeams, um die Verbindung herzustellen.


Connect-MicrosoftTeams

Sie werden aufgefordert, sich anzumelden. Geben Sie Ihre Microsoft Teams-Anmeldeinformationen ein, um über PowerShell eine Verbindung mit Teams herzustellen. Dieses Popup ist MFA-fähig. Selbst wenn in Ihrem Konto die Multi-Faktor-Authentifizierung aktiviert ist, können Sie sich also bei PowerShell anmelden und eine Verbindung zu Microsoft Teams herstellen. Stellen Sie sicher, dass Sie über die Besitzerrechte für das Team verfügen, dem Sie die Benutzer hinzufügen möchten.

Schritt 2: Rufen Sie die Gruppen-ID des Microsoft-Teams ab

Der nächste Schritt besteht darin, die mit dem jeweiligen Team verknüpfte Gruppen-ID zu ermitteln.

Wenn in Microsoft Teams ein Team erstellt wird, wird im Backend auch eine zugehörige Microsoft 365-Gruppe erstellt. Dies fungiert als Rückgrat für die Teams. Um das Team zu verwalten, müssen wir also die ID der zugehörigen Gruppe erhalten. Lassen Sie uns die Gruppen-ID aus dem Anzeigenamen des Teams ermitteln:


#Get Team ID from Display Name
Get-Team | Where {$_.DisplayName -eq "Learning Portal"} | Select -ExpandProperty GroupID

Wenn Sie sich über den Anzeigenamen der Teams nicht sicher sind, verwenden Sie einfach das Cmdlet „Get-Team“, um alle Teams in Ihrer Umgebung abzurufen.


#Get All Teams
Get-Team

Schritt 3: Füllen Sie eine CSV-Datei mit Benutzern aus, die dem Team hinzugefügt werden sollen

Hier ist meine CSV-Datei. Geben Sie einfach die E-Mail-Adressen der Benutzer und die Rolle an, die Sie Mitgliedern oder Eigentümern in der CSV zuweisen möchten.

Hier habe ich die E-Mail-Adresse des Benutzers und die Rolle zur Zuweisung in der CSV-Datei verwendet. Sie können TeamName auch als Parameter verwenden.

Schritt 4: Importieren Sie Benutzer mithilfe von PowerShell aus CSV in Microsoft Teams

Abschließend finden Sie hier das vollständige PowerShell-Skript zum Hinzufügen mehrerer Benutzer zu einem vorhandenen Microsoft Teams-Team aus einer CSV-Datei!


#Get users from the CSV
$TeamUsers = Import-Csv -Path "C:\Temp\TeamsUsers.csv"

#Iterate through each user from the CSV and add to Teams
$TeamUsers | ForEach-Object {
       Add-TeamUser -GroupId $TeamID -User $_.Email -Role $_.Role
       Write-host "Added User:"$_.Email -f Green
}

PowerShell-Skript zum Massenhinzufügen von Benutzern zu Microsoft Teams

Lassen Sie uns Parameter einführen und den obigen Abschnitten etwas Fehlerbehandlung hinzufügen. Hier ist das vollständige Skript zum Massenhinzufügen von Benutzern zu Microsoft Teams aus einer CSV-Datei:


#Parameters
$CSVPath = "C:\Temp\TeamsUsersTemplate.csv"
$TeamDisplayName = "Learning Portal"

Try {
    #Connect to Microsoft Teams
    Connect-MicrosoftTeams

    #Get Team ID from Display Name
    $TeamID = Get-Team | Where {$_.DisplayName -eq $TeamDisplayName} | Select -ExpandProperty GroupID

    #Get users from the CSV
    $TeamUsers = Import-Csv -Path $CSVPath

    #Iterate through each user from the CSV and add to Teams
    $TeamUsers | ForEach-Object {
        Try {
            Add-TeamUser -GroupId $TeamID -User $_.Email -Role $_.Role
            Write-host "Added User:"$_.Email -f Green
        }
        Catch {
            Write-host -f Red "Error Adding User to the Team:" $_.Exception.Message
        }
    }
}
Catch {
    write-host -f Red "Error:" $_.Exception.Message
}

Sie können dieses Skript auch verwenden, um Gastbenutzer in großen Mengen zu Microsoft Teams hinzuzufügen!

Verwandte Artikel